ConvertSidToStringSidA-Funktion (sddl.h)

Artikel
11/20/2024

Die ConvertSidToStringSid--Funktion konvertiert einen Sicherheitsbezeichner (SID) in ein Zeichenfolgenformat, das zum Anzeigen, Speichern oder Übertragen geeignet ist.

Rufen Sie die ConvertStringSidToSid-Funktion 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 SID- Struktur, die konvertiert werden soll.

[out] StringSid

Ein Zeiger auf eine Variable, die einen Zeiger auf eine null-beendete SID-Zeichenfolge empfängt. Rufen Sie zum Freigeben des zurückgegebenen Puffers die funktion LocalFree auf.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlschlägt, ist der Rückgabewert null. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten. Die GetLastError--Funktion kann einen der folgenden Fehlercodes zurückgeben.

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 am häufigsten ein ungültiger Zeiger.

Bemerkungen

Die ConvertSidToStringSid-Funktion verwendet die Standardfunktion S-R-I-S-S... Format für SID-Zeichenfolgen. Weitere Informationen zur SID-Zeichenfolgennotation finden Sie unter SID-Komponenten.

Anmerkung

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
mindestens unterstützte Client-	Windows XP [Desktop-Apps \| UWP-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Desktop-Apps \| UWP-Apps]
Zielplattform-	Fenster
Header-	sddl.h
Library	Advapi32.lib
DLL-	Advapi32.dll