Freigeben über


SetFileSecurityA-Funktion (winbase.h)

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

Weitere Informationen

GetFileSecurity

Low-Level-Access Control

Low-Level-Access Control Functions

SECURITY_DESCRIPTOR

SECURITY_INFORMATION

SetKernelObjectSecurity

SetNamedSecurityInfo

SetPrivateObjectSecurity

SetUserObjectSecurity