Freigeben über


ConvertSidToStringSidA-Funktion (sddl.h)

Die ConvertSidToStringSid-Funktion konvertiert einen Sicherheitsbezeichner (SID) in ein Zeichenfolgenformat, das für die Anzeige, Speicherung oder Übertragung geeignet ist.

Rufen Sie die Funktion ConvertStringSidToSid auf, um die Zeichenfolgenformat-SID wieder in eine gültige funktionale SID zu konvertieren.

Syntax

BOOL ConvertSidToStringSidA(
  [in]  PSID  Sid,
  [out] LPSTR *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 beendete 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
ERROR_NOT_ENOUGH_MEMORY
Nicht genügend Arbeitsspeicher.
ERROR_INVALID_SID
Die SID ist ungültig.
ERROR_INVALID_PARAMETER
Einer der Parameter enthält einen ungültigen Wert. Dies ist in den meisten Fällen ein nicht gültiger Zeiger.

Hinweise

Die ConvertSidToStringSid-Funktion verwendet den 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 nicht codierungsneutralem Code 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

Zugriffssteuerung Übersicht

Grundlegende Access Control-Funktionen

ConvertSecurityDescriptorToStringSecurityDescriptor

ConvertStringSecurityDescriptorToSecurityDescriptor

ConvertStringSidToSid

SID