Función RtlConvertSidToUnicodeString (winternl.h)

[La función RtlConvertSidToUnicodeString está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. En versiones posteriores podría modificarse o no estar disponible. En su lugar, use la función ConvertSidToStringSid .

La función RtlConvertSidToUnicodeString convierte un identificador de seguridad (SID) en su representación de caracteres Unicode. Esta función no tiene ninguna biblioteca de importación asociada. Debe usar las funciones LoadLibrary y GetProcAddress para vincular dinámicamente a Ntdll.dll.

Sintaxis

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

Parámetros

[out] UnicodeString

Puntero a la representación de caracteres Unicode del identificador de seguridad.

[in] Sid

Puntero a la estructura del SID que representa el identificador de seguridad.

[in] AllocateDestinationString

Si es TRUE, Se asigna UnicodeString en nombre del autor de la llamada y es responsabilidad del autor de la llamada liberar la memoria asignada llamando a la función RtlFreeUnicodeString . Si es FALSE, el autor de la llamada es responsable de asignar y liberar UnicodeString.

Valor devuelto

El valor devuelto es un código NTSTATUS. Se devuelve un valor de STATUS_SUCCESS (0x000000000L) si la función se realiza correctamente.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winternl.h
Library	ntdll.lib
Archivo DLL	ntdll.dll