Compartilhar via


Função RtlConvertSidToUnicodeString (winternl.h)

[A função RtlConvertSidToUnicodeString está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele poderá ser alterado ou ficar indisponível em versões subsequentes. Em vez disso, use a função ConvertSidToStringSid .]

A função RtlConvertSidToUnicodeString converte um SID ( identificador de segurança ) em sua representação de caractere Unicode. Essa função não tem biblioteca de importação associada. Você deve usar as funções LoadLibrary e GetProcAddress para vincular dinamicamente a Ntdll.dll.

Sintaxe

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

Parâmetros

[out] UnicodeString

Um ponteiro para a representação de caractere Unicode do identificador de segurança.

[in] Sid

Um ponteiro para a estrutura sid que representa o identificador de segurança.

[in] AllocateDestinationString

Se TRUE, UnicodeString é alocado em nome do chamador e é responsabilidade do chamador liberar a memória alocada chamando a função RtlFreeUnicodeString . Se FALSE, o chamador será responsável por alocar e liberar UnicodeString.

Retornar valor

O valor retornado é um código NTSTATUS. Um valor de STATUS_SUCCESS (0x00000000L) será retornado se a função for bem-sucedida.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winternl.h
Biblioteca ntdll.lib
DLL ntdll.dll