DecryptFileA 函数 (winbase.h)
解密加密的文件或目录。
语法
BOOL DecryptFileA(
[in] LPCSTR lpFileName,
DWORD dwReserved
);
参数
[in] lpFileName
要解密的文件或目录的名称。
调用方必须具有 FILE_READ_DATA、FILE_WRITE_DATA、FILE_READ_ATTRIBUTES、FILE_WRITE_ATTRIBUTES和 SYNCHRONIZE 访问权限。 有关详细信息,请参阅 文件安全和访问权限。
dwReserved
保留;必须为零。
返回值
如果函数成功,则返回值为非零。
如果函数失败,则返回值为零。 若要获取扩展的错误信息,请调用 GetLastError。
言论
DecryptFile 函数需要对正在解密的文件进行独占访问,如果另一个进程正在使用该文件,将失败。 如果未加密文件,DecryptFile 仅返回非零值,表示成功。
如果 lpFileName 指定只读文件,则函数将失败,GetLastError 返回 ERROR_FILE_READ_ONLY。 如果 lpFileName 指定包含只读文件的目录,则函数会成功,但目录未解密。
在 Windows 8、Windows Server 2012 及更高版本中,以下技术支持此函数。
科技 | 支持 |
---|---|
服务器消息块 (SMB) 3.0 协议 | 是的 |
SMB 3.0 透明故障转移 (TFO) | 不 |
具有横向扩展文件共享的 SMB 3.0 (SO) | 不 |
群集共享卷文件系统 (CsvFS) | 不 |
可复原文件系统 (ReFS) | 不 |
SMB 3.0 不支持具有持续可用性功能的共享上的 EFS。
注意
winbase.h 标头将 DecryptFile 定义为一个别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息,请参阅函数原型的
要求
要求 | 价值 |
---|---|
最低支持的客户端 | Windows XP [仅限桌面应用] |
支持的最低服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | 窗户 |
标头 | winbase.h (包括 Windows.h) |
库 | Advapi32.lib |
DLL | Advapi32.dll |
API 集 | ext-ms-win-advapi32-encryptedfile-l1-1-0(在 Windows 8 中引入) |