AddUsersToEncryptedFile 函式 (winefs.h)

  • 發行項

將使用者金鑰新增至指定的加密檔案。

語法

DWORD AddUsersToEncryptedFile(
  [in] LPCWSTR                      lpFileName,
  [in] PENCRYPTION_CERTIFICATE_LIST pEncryptionCertificates
);

參數

[in] lpFileName

加密檔案的名稱。

[in] pEncryptionCertificates

ENCRYPTION_CERTIFICATE_LIST 結構的指標，其中包含要新增至檔案的新使用者索引鍵清單。

傳回值

如果函式成功，傳回值 會ERROR_SUCCESS。

如果函式失敗，則傳回值是系統錯誤碼。 如需錯誤碼的完整清單，請參閱 系統錯誤碼 或頭檔 WinError.h。

備註

從 Windows 8 和 Windows Server 2012 開始，下列技術支援此函式。

技術 支援
伺服器消息塊 (SMB) 3.0 通訊協定 No
SMB 3.0 透明故障轉移 (TFO) No
具有向外延展檔案共用的SMB 3.0 (SO) No
叢集共用磁碟區文件系統 (CsvFS) No
彈性檔案系統 (ReFS) No
 

SMB 3.0 不支援具有持續可用性功能的共用上的EFS。

範例

如需使用此函式的程式碼範例，請參閱 將使用者新增至加密檔案。

規格需求

需求 值
最低支援的用戶端 Windows XP Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平台 Windows
標頭 winefs.h (包括 Windows.h)
程式庫 Advapi32.lib
Dll Advapi32.dll
API 集合 ext-ms-win-advapi32-encryptedfile-l1-1-1 (於 Windows 10 10.0.14393 版)

另請參閱

ENCRYPTION_CERTIFICATE_LIST

檔案加密

檔案管理功能