nf-bits2_0-ibackgroundcopyjob3-getfileaclflags.md

UID	title	description	helpviewer_keywords	old-location	tech.root	ms.assetid	ms.date	ms.keywords	req.header	req.include-header	req.target-type	req.target-min-winverclnt	req.target-min-winversvr	req.kmdf-ver	req.umdf-ver	req.ddi-compliance	req.unicode-ansi	req.idl	req.max-support	req.namespace	req.assembly	req.type-library	req.lib	req.dll	req.irql	targetos	req.typenames	req.redist	ms.custom	f1_keywords	dev_langs	topic_type	api_type	api_location	api_name
NF:bits2_0.IBackgroundCopyJob3.GetFileACLFlags	IBackgroundCopyJob3::GetFileACLFlags (bits2_0.h)	Retrieves the flags that identify the owner and ACL information to maintain when transferring a file using SMB.	BG_COPY_FILE_ALL BG_COPY_FILE_DACL BG_COPY_FILE_GROUP BG_COPY_FILE_OWNER BG_COPY_FILE_SACL GetFileACLFlags GetFileACLFlags method [BITS] GetFileACLFlags method [BITS] IBackgroundCopyJob3 interface IBackgroundCopyJob3 interface [BITS] GetFileACLFlags method IBackgroundCopyJob3.GetFileACLFlags IBackgroundCopyJob3::GetFileACLFlags bits.ibackgroundcopyjob3_getfileaclflags bits2_0/IBackgroundCopyJob3::GetFileACLFlags	bits\ibackgroundcopyjob3_getfileaclflags.htm	Bits	569df1e5-d45a-4f18-82ad-1e4957f47d94	12/05/2018	BG_COPY_FILE_ALL, BG_COPY_FILE_DACL, BG_COPY_FILE_GROUP, BG_COPY_FILE_OWNER, BG_COPY_FILE_SACL, GetFileACLFlags, GetFileACLFlags method [BITS], GetFileACLFlags method [BITS],IBackgroundCopyJob3 interface, IBackgroundCopyJob3 interface [BITS],GetFileACLFlags method, IBackgroundCopyJob3.GetFileACLFlags, IBackgroundCopyJob3::GetFileACLFlags, bits.ibackgroundcopyjob3_getfileaclflags, bits2_0/IBackgroundCopyJob3::GetFileACLFlags	bits2_0.h	Bits.h	Windows	Windows Vista, Windows XP with SP2,KB842773 on Windows Server 2003, and Windows XP	Windows Server 2008, Windows Server 2003 with SP1					Bits2_0.idl					Bits.lib	BitsPrx3.dll		Windows			19H1	IBackgroundCopyJob3::GetFileACLFlags bits2_0/IBackgroundCopyJob3::GetFileACLFlags	c++	APIRef kbSyntax	COM	BitsPrx3.dll	IBackgroundCopyJob3.GetFileACLFlags

IBackgroundCopyJob3::GetFileACLFlags

-description

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

-parameters

-param 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, 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.

-returns

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

Return code	Description
S_OK	Successfully retrieved the flags.

-see-also

IBackgroundCopyJob3

IBackgroundCopyJob3::SetFileACLFlags