Condividi tramite


Funzione ConvertSidToStringSidA (sddl.h)

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 ConvertSidToStringSidA(
  [in]  PSID  Sid,
  [out] LPSTR *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

Vedi anche

Panoramica di Controllo di accesso

Funzioni Controllo di accesso di base

ConvertSecurityDescriptorToStringSecurityDescriptor

ConvertStringSecurityDescriptorToSecurityDescriptor

ConvertStringSidToSid

SID