Edit

IBackgroundCopyJob3::GetFileACLFlags method (bits2_0.h)

  • Article

Retrieves the flags that identify the owner and ACL information to maintain when transferring a file using SMB.

Syntax

HRESULT GetFileACLFlags(
  [out] DWORD *Flags
);

Parameters

[out] Flags

Flags that identify the owner and ACL information to maintain when transferring a file using SMB. Flags can contain any combination of the following flags. If no flags are set, Flags is zero.

Value Meaning
BG_COPY_FILE_OWNER
 If set, the file's owner information is maintained. Otherwise, the job's owner becomes the owner of the file.
BG_COPY_FILE_GROUP
 If set, the file's group information is maintained. Otherwise, BITS uses the job owner's primary group to assign the group information to the file.
BG_COPY_FILE_DACL
 If set, BITS copies the explicit ACEs from the source file and inheritable ACEs from the destination parent folder. Otherwise, BITS copies the inheritable ACEs from the destination parent folder. If the parent folder does not contain inheritable ACEs, BITS uses the default DACL from the account.
BG_COPY_FILE_SACL
 If set, BITS copies the explicit ACEs from the source file and inheritable ACEs from the destination parent folder. Otherwise, BITS copies the inheritable ACEs from the destination parent folder.
BG_COPY_FILE_ALL
 If set, BITS copies the owner and ACL information. This is the same as setting all the flags individually.

Return value

This method returns the following HRESULT values, as well as others.

Return code Description
S_OK
 Successfully retrieved the flags.

Requirements

Requirement Value
Minimum supported client Windows Vista, Windows XP with SP2,KB842773 on Windows Server 2003, and Windows XP
Minimum supported server Windows Server 2008, Windows Server 2003 with SP1
Target Platform Windows
Header bits2_0.h (include Bits.h)
Library Bits.lib
DLL BitsPrx3.dll

See also

IBackgroundCopyJob3

IBackgroundCopyJob3::SetFileACLFlags