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