SetFileSecurityA-Funktion (winbase.h)

Artikel
03/06/2024

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

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

Syntax

BOOL SetFileSecurityA(
  [in] LPCSTR               lpFileName,
  [in] SECURITY_INFORMATION SecurityInformation,
  [in] PSECURITY_DESCRIPTOR pSecurityDescriptor
);

Parameter

[in] lpFileName

Ein Zeiger auf eine NULL-endende Zeichenfolge, die die Datei oder das Verzeichnis angibt, für die 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 ungleich null zurück.

Wenn die Funktion fehlschlägt, wird null zurückgegeben. 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 DACL (Discretionary Access Control List ) des Objekts festgelegt wird, muss der aufrufende Prozess entweder über WRITE_DAC Berechtigung verfügen oder der Besitzer des Objekts sein.
Wenn die Systemzugriffssteuerungsliste (SACL) des Objekts festgelegt wird, muss die berechtigung SE_SECURITY_NAME für den aufrufenden Prozess aktiviert werden.

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	winbase.h (Windows.h einschließen)
Bibliothek	Advapi32.lib
DLL	Advapi32.dll