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 |