IBackgroundCopyJob3::GetFileACLFlags-Methode (bits2_0.h)

Artikel
08/22/2023

Ruft die Flags ab, die die Besitzer- und ACL-Informationen identifizieren, die beim Übertragen einer Datei mit SMB verwaltet werden sollen.

Syntax

HRESULT GetFileACLFlags(
  [out] DWORD *Flags
);

Parameter

[out] Flags

Flags, die den Besitzer und die ACL-Informationen identifizieren, die beim Übertragen einer Datei mit SMB beibehalten werden sollen. Flags können eine beliebige Kombination der folgenden Flags enthalten. Wenn keine Flags festgelegt sind, ist flags null.

Wert	Bedeutung
BG_COPY_FILE_OWNER	Falls festgelegt, werden die Besitzerinformationen der Datei beibehalten. Andernfalls wird der Besitzer des Auftrags zum Besitzer der Datei.
BG_COPY_FILE_GROUP	Wenn festgelegt, werden die Gruppeninformationen der Datei beibehalten. Andernfalls verwendet BITS die primäre Gruppe des Auftragsbesitzers, um die Gruppeninformationen der Datei zuzuweisen.
BG_COPY_FILE_DACL	Falls festgelegt, kopiert BITS die expliziten ACEs aus der Quelldatei und vererbbare ACEs aus dem übergeordneten Zielordner. Andernfalls kopiert BITS die vererbbaren ACEs aus dem übergeordneten Zielordner. Wenn der übergeordnete Ordner keine vererbbaren ACEs enthält, verwendet BITS die Standard-DACL des Kontos.
BG_COPY_FILE_SACL	Falls festgelegt, kopiert BITS die expliziten ACEs aus der Quelldatei und vererbbare ACEs aus dem übergeordneten Zielordner. Andernfalls kopiert BITS die vererbbaren ACEs aus dem übergeordneten Zielordner.
BG_COPY_FILE_ALL	Falls festgelegt, kopiert BITS die Besitzer- und ACL-Informationen. Dies ist identisch mit dem Festlegen aller Flags einzeln.

Rückgabewert

Diese Methode gibt die folgenden HRESULT-Werte sowie andere zurück.

Rückgabecode	Beschreibung
S_OK	Die Flags wurden erfolgreich abgerufen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista, Windows XP mit SP2, KB842773 unter Windows Server 2003 und Windows XP
Unterstützte Mindestversion (Server)	Windows Server 2008, Windows Server 2003 mit SP1
Zielplattform	Windows
Kopfzeile	bits2_0.h (Bits.h einschließen)
Bibliothek	Bits.lib
DLL	BitsPrx3.dll

Weitere Informationen

IBackgroundCopyJob3

IBackgroundCopyJob3::SetFileACLFlags

Share via