Funzione RtlConvertSidToUnicodeString (winternl.h)

Articolo
02/01/2024

[La funzione RtlConvertSidToUnicodeString è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. È possibile che in versioni successive sia stata modificata o non sia più disponibile. Usare invece la funzione ConvertSidToStringSid .]

La funzione RtlConvertSidToUnicodeString converte un identificatore di sicurezza (SID) nella relativa rappresentazione di caratteri Unicode. Questa funzione non ha alcuna libreria di importazione associata. È necessario usare le funzioni LoadLibrary e GetProcAddress per collegare dinamicamente a Ntdll.dll.

Sintassi

NTSTATUS RtlConvertSidToUnicodeString(
  [out] PUNICODE_STRING UnicodeString,
  [in]  PSID            Sid,
  [in]  BOOLEAN         AllocateDestinationString
);

Parametri

[out] UnicodeString

Puntatore alla rappresentazione dei caratteri Unicode dell'identificatore di sicurezza.

[in] Sid

Puntatore alla struttura SID che rappresenta l'identificatore di sicurezza.

[in] AllocateDestinationString

Se TRUE, UnicodeString viene allocato per conto del chiamante ed è responsabilità del chiamante liberare la memoria allocata chiamando la funzione RtlFreeUnicodeString . Se FALSE, il chiamante è responsabile dell'allocazione e della liberazione di UnicodeString.

Valore restituito

Il valore restituito è un codice NTSTATUS. Se la funzione ha esito positivo, viene restituito un valore di STATUS_SUCCESS (0x00000000L).

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winternl.h
Libreria	ntdll.lib
DLL	ntdll.dll

Share via