ConvertStringSidToSidA-Funktion (sddl.h)

Artikel
03/01/2024

Die ConvertStringSidToSid-Funktion konvertiert einen Zeichenfolgenformat-Sicherheitsbezeichner (SID) in eine gültige, funktionale SID. Sie können diese Funktion verwenden, um eine SID abzurufen, die die ConvertSidToStringSid-Funktion in das Zeichenfolgenformat konvertiert hat.

Syntax

BOOL ConvertStringSidToSidA(
  [in]  LPCSTR StringSid,
  [out] PSID   *Sid
);

Parameter

[in] StringSid

Ein Zeiger auf eine NULL-Zeichenfolge, die die zu konvertierende SID im Zeichenfolgenformat enthält.

Die SID-Zeichenfolge kann entweder die Standard-S-R-I-S-S... Format für SID-Zeichenfolgen oder das SID-Zeichenfolgenkonstanteformat, z. B. "BA" für integrierte Administratoren. Weitere Informationen zur SID-Zeichenfolgennotation finden Sie unter SID-Komponenten.

[out] Sid

Ein Zeiger auf eine Variable, die einen Zeiger auf die konvertierte SID 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_INVALID_PARAMETER	Ungültiger Parameter.
ERROR_INVALID_SID	Ungültige SID.

Hinweise

Hinweis

Der sddl.h-Header definiert ConvertStringSidToSid als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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