IBackgroundCopyJob3：：GetFileACLFlags 方法 (bits2_0.h)

擷取旗標，以識別使用SMB傳輸檔案時所要維護的擁有者和ACL資訊。

語法

HRESULT GetFileACLFlags(
  [out] DWORD *Flags
);

[out] Flags

旗標，識別使用SMB傳輸檔案時所要維護的擁有者和ACL資訊。旗標可以包含下列旗標的任何組合。如果未設定任何旗標， 則 Flags 為 零。

值	意義
BG_COPY_FILE_OWNER	如果設定，則會維護檔案的擁有者資訊。否則，作業的擁有者會成為檔案的擁有者。
BG_COPY_FILE_GROUP	如果設定，則會維護檔案的群組資訊。否則，BITS 會使用作業擁有者的主要群組，將群組資訊指派給檔案。
BG_COPY_FILE_DACL	如果設定，BITS 會從來源檔案複製明確的 ACE，並從目的地父資料夾複製可繼承的 ACE。否則，BITS 會從目的地父資料夾複製可繼承的ACE。如果父資料夾不包含可繼承的 ACE，BITS 會使用帳戶中的預設 DACL。
BG_COPY_FILE_SACL	如果設定，BITS 會從來源檔案複製明確的 ACE，並從目的地父資料夾複製可繼承的 ACE。否則，BITS 會從目的地父資料夾複製可繼承的ACE。
BG_COPY_FILE_ALL	如果設定，BITS 會複製擁有者和 ACL 資訊。這與個別設定所有旗標相同。

這個方法會傳回下列 HRESULT 值，以及其他值。

傳回碼	Description
S_OK	已成功擷取旗標。

需求	值
最低支援的用戶端	Windows Vista、Windows XP SP2、KB842773 Windows Server 2003 和 Windows XP
最低支援的伺服器	Windows Server 2008、Windows Server 2003 SP1
目標平台	Windows
標頭	bits2_0.h (包含 Bits.h)
程式庫	Bits.lib
Dll	BitsPrx3.dll