IBackgroundCopyJob3::GetFileACLFlags method

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

Flags [out]

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.

ValueMeaning
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 codeDescription
S_OK

Successfully retrieved the flags.

 

Requirements

Minimum supported client

Windows Vista, Windows XP with SP2

Minimum supported server

Windows Server 2008, Windows Server 2003 with SP1

Version

KB842773 on Windows Server 2003, and Windows XP

Header

Bits2_0.h (include Bits.h)

IDL

Bits2_0.idl

Library

Bits.lib

DLL

BitsPrx3.dll

IID

IID_IBackgroundCopyJob3 is defined as 443C8934-90FF-48ED-BCDE-26F5C7450042

See also

IBackgroundCopyJob3::SetFileACLFlags
IBackgroundCopyJob3

 

 

Show: