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 不支持具有连续可用性功能的共享上的 EFS。

注意

winbase.h 标头将 DecryptFile 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。有关详细信息，请参阅函数原型的约定。


最低受支持的客户端	Windows XP [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
目标平台	Windows
标头	winbase.h (包括 Windows.h)
Library	Advapi32.lib
DLL	Advapi32.dll
API 集	windows 8 中引入的 ext-ms-win-advapi32-encryptedfile-l1-1-0 ()