ConvertSidToStringSidW-Funktion (sddl.h)
Die ConvertSidToStringSid-Funktion konvertiert eine Sicherheits-ID (SID) in ein Zeichenfolgenformat, das für die Anzeige, Speicherung oder Übertragung geeignet ist.
Rufen Sie die ConvertStringSidToSid-Funktion auf, um die Zeichenfolgenformat-SID wieder in eine gültige funktionale SID zu konvertieren.
Syntax
BOOL ConvertSidToStringSidW(
[in] PSID Sid,
[out] LPWSTR *StringSid
);
Parameter
[in] Sid
Ein Zeiger auf die zu konvertierende SID-Struktur .
[out] StringSid
Ein Zeiger auf eine Variable, die einen Zeiger auf eine MIT NULL endende SID-Zeichenfolge empfängt. Um den zurückgegebenen Puffer freizugeben, rufen Sie die Funktion LocalFree auf .
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf. Die GetLastError-Funktion gibt möglicherweise einen der folgenden Fehlercodes zurück.
Rückgabecode | Beschreibung |
---|---|
|
Nicht genügend Arbeitsspeicher. |
|
Die SID ist ungültig. |
|
Einer der Parameter enthält einen ungültigen Wert. Dies ist in den meisten Fällen ein ungültiger Zeiger. |
Hinweise
Die ConvertSidToStringSid-Funktion verwendet die Standard-S-R-I-S S-... Format für SID-Zeichenfolgen. Weitere Informationen zur SID-Zeichenfolgennotation finden Sie unter SID-Komponenten.
Hinweis
Der sddl.h-Header definiert ConvertSidToStringSid als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows XP [Desktop-Apps | UWP-Apps] |
Unterstützte Mindestversion (Server) | Windows Server 2003 [Desktop-Apps | UWP-Apps] |
Zielplattform | Windows |
Kopfzeile | sddl.h |
Bibliothek | Advapi32.lib |
DLL | Advapi32.dll |
Weitere Informationen
Grundlegende Access Control-Funktionen
ConvertSecurityDescriptorToStringSecurityDescriptor
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für