Funzione ConvertStringSidToSidA (sddl.h)

Articolo
03/01/2024

La funzione ConvertStringSidToSid converte un SID (String-Format Security Identifier) in un SID funzionale valido. È possibile usare questa funzione per recuperare un SID convertito dalla funzione ConvertSidToStringSid in formato stringa.

Sintassi

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

Parametri

[in] StringSid

Puntatore a una stringa con terminazione Null contenente il SID in formato stringa da convertire.

La stringa SID può usare lo standard S-R-I-S-... formato per stringhe SID o formato costante stringa SID, ad esempio "BA" per gli amministratori predefiniti. Per altre informazioni sulla notazione di stringhe SID, vedere COMPONENTI SID.

[out] Sid

Puntatore a una variabile che riceve un puntatore al SID convertito. Per liberare il buffer restituito, chiamare la funzione LocalFree .

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError. La funzione GetLastError può restituire uno dei codici di errore seguenti.

Codice restituito	Descrizione
ERROR_INVALID_PARAMETER	Parametro non valido.
ERROR_INVALID_SID	SID non valido.

Commenti

Nota

L'intestazione sddl.h definisce ConvertStringSidToSid Come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [app desktop \| App UWP]
Server minimo supportato	Windows Server 2003 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	sddl.h
Libreria	Advapi32.lib
DLL	Advapi32.dll