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.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, DO uses the job owner's primary group to assign the group information to the file.
BG_COPY_FILE_DACL If set, DO copies the explicit ACEs from the source file and inheritable ACEs from the destination parent folder. Otherwise, DO copies the inheritable ACEs from the destination parent folder. If the parent folder does not contain inheritable ACEs, DO uses the default DACL from the account.
BG_COPY_FILE_SACL If set, DO copies the explicit ACEs from the source file and inheritable ACEs from the destination parent folder. Otherwise, DO copies the inheritable ACEs from the destination parent folder.
BG_COPY_FILE_ALL If set, DO 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
Minimum supported client |
Windows 10, version 1709 [desktop apps only] |
Minimum supported server |
Windows Server 2016 [desktop apps only] |
Header |
Deliveryoptimization.h |
IDL |
DeliveryOptimization.idl |
Library |
Dosvc.lib |
DLL |
Dosvc.dll |
IID |
IID_IBackgroundCopyJob3 is defined as 443C8934-90FF-48ED-BCDE-26F5C7450042 |