QueryUsersOnEncryptedFile 函式 (winefs.h)

  • 發行項

擷取指定檔案的使用者清單。

語法

DWORD QueryUsersOnEncryptedFile(
  [in]  LPCWSTR                           lpFileName,
  [out] PENCRYPTION_CERTIFICATE_HASH_LIST *pUsers
);

參數

[in] lpFileName

檔案的名稱。

[out] pUsers

接收使用者清單之 ENCRYPTION_CERTIFICATE_HASH_LIST 結構的指標。

傳回值

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

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

備註

不再需要使用者清單時，請呼叫 FreeEncryptionCertificateHashList 函式以釋放清單。

在 Windows 8、Windows Server 2012 和更新版本中，下列技術支援此函式。

技術 支援
伺服器訊息區 (SMB) 3.0 通訊協定 Yes
SMB 3.0 透明容錯移轉 (TFO) 否
具有向外延展檔案共用的 SMB 3.0 (SO) 否
叢集共用磁片區檔案系統 (CsvFS) 否
彈性檔案系統 (ReFS) 否
 

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-0 (在 Windows 8)

另請參閱

ENCRYPTION_CERTIFICATE_HASH_LIST

檔案加密

檔案管理功能

FreeEncryptionCertificateHashList