Funzione ConvertSidToStringSidW (sddl.h)

Articolo
03/05/2024

La funzione ConvertSidToStringSid converte un IDENTIFICATORe di sicurezza (SID) in un formato stringa adatto per la visualizzazione, l'archiviazione o la trasmissione.

Per convertire il SID in formato stringa in un SID funzionale valido, chiamare la funzione ConvertStringSidToSidToSid .

Sintassi

BOOL ConvertSidToStringSidW(
  [in]  PSID   Sid,
  [out] LPWSTR *StringSid
);

Parametri

[in] Sid

Puntatore alla struttura SID da convertire.

[out] StringSid

Puntatore a una variabile che riceve un puntatore a una stringa SID con terminazione Null. 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_NOT_ENOUGH_MEMORY	Memoria insufficiente.
ERROR_INVALID_SID	IL SID non è valido.
ERROR_INVALID_PARAMETER	Uno dei parametri contiene un valore non valido. Si tratta più spesso di un puntatore che non è valido.

Commenti

La funzione ConvertSidToStringSid usa lo standard S-R-I-S...- formato per stringhe SID. Per altre informazioni sulla notazione di stringhe SID, vedere COMPONENTI SID.

Nota

L'intestazione sddl.h definisce ConvertSidToStringSid 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