IBackgroundCopyJob3::GetFileACLFlags メソッド (bits2_0.h)

SMB を使用してファイルを転送するときに保持する所有者と ACL 情報を識別するフラグを取得します。

構文

HRESULT GetFileACLFlags(
  [out] DWORD *Flags
);

[out] Flags

SMB を使用してファイルを転送するときに保持する所有者と ACL 情報を識別するフラグ。 フラグ には、次のフラグの任意の組み合わせを含めることができます。フラグが設定されていない場合、 Flags は 0 です。

値	意味
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 値と他の値を返します。

リターンコード	説明
S_OK	フラグが正常に取得されました。

要件	値
サポートされている最小のクライアント	Windows Vista、Windows XP SP2、Windows Server 2003 のKB842773、Windows XP
サポートされている最小のサーバー	Windows Server 2008、Windows Server 2003 SP1
対象プラットフォーム	Windows
ヘッダー	bits2_0.h (Bits.h を含む)
Library	Bits.lib
[DLL]	BitsPrx3.dll