Freigeben über

SetFileSecurityW-Funktion (securitybaseapi.h)

  • Artikel

Die SetFileSecurity-Funktion legt die Sicherheit eines Datei- oder Verzeichnisobjekts fest.

Diese Funktion ist veraltet. Verwenden Sie stattdessen die Funktion SetNamedSecurityInfo .

Syntax

BOOL SetFileSecurityW(
  [in] LPCWSTR              lpFileName,
  [in] SECURITY_INFORMATION SecurityInformation,
  [in] PSECURITY_DESCRIPTOR pSecurityDescriptor
);

Parameter

[in] lpFileName

Ein Zeiger auf eine NULL-Zeichenfolge, die die Datei oder das Verzeichnis angibt, für das die Sicherheit festgelegt ist. Beachten Sie, dass die auf ein Verzeichnis angewendete Sicherheit nicht von den untergeordneten Elementen geerbt wird.

[in] SecurityInformation

Gibt eine SECURITY_INFORMATION-Struktur an, die den Inhalt des Sicherheitsdeskriptors identifiziert, auf den der pSecurityDescriptor-Parameter verweist.

[in] pSecurityDescriptor

Ein Zeiger auf eine SECURITY_DESCRIPTOR-Struktur .

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion nonzero zurück.

Wenn die Funktion fehlschlägt, gibt sie null zurück. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Die SetFileSecurity-Funktion ist nur erfolgreich, wenn die folgenden Bedingungen erfüllt sind:

  • Wenn der Besitzer des Objekts festgelegt wird, muss der aufrufende Prozess entweder über WRITE_OWNER Berechtigung verfügen oder der Besitzer des Objekts sein.
  • Wenn die diskretionäre Zugriffssteuerungsliste (DACL) des Objekts festgelegt wird, muss der aufrufende Prozess entweder über WRITE_DAC Berechtigung verfügen oder der Besitzer des Objekts sein.
  • Wenn die Systemzugriffssteuerungsliste (System Access Control List , SACL) des Objekts festgelegt wird, muss die berechtigung SE_SECURITY_NAME für den aufrufenden Prozess aktiviert sein.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile securitybaseapi.h (einschließlich Windows.h)
Bibliothek Advapi32.lib
DLL Advapi32.dll

Weitere Informationen

GetFileSecurity
Low-Level-Access Control
Access Control funktionen auf niedriger Ebene
SECURITY_DESCRIPTOR
SECURITY_INFORMATION
SetKernelObjectSecurity
SetNamedSecurityInfoSetPrivateObjectSecuritySecurity
SetUserObjectSecurity