Função ConvertSidToStringSidW (sddl.h)

Artigo
11/20/2024

A função ConvertSidToStringSid converte um SID ( identificador de segurança) em um formato de cadeia de caracteres adequado para exibição, armazenamento ou transmissão.

Para converter o SID em formato de cadeia de caracteres de volta em um SID válido e funcional, chame a função ConvertStringSidToSid.

Sintaxe

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

Parâmetros

[in] Sid

Um ponteiro para a estrutura de SID a ser convertida.

[out] StringSid

Um ponteiro para uma variável que recebe um ponteiro para uma cadeia de caracteres SID terminada em nulo. Para liberar o buffer retornado, chame a função LocalFree.

Valor de retorno

Se a função for bem-sucedida, o valor retornado não será zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError. A função GetLastError pode retornar um dos seguintes códigos de erro.

Código de retorno	Descrição
ERROR_NOT_ENOUGH_MEMORY	Memória insuficiente.
ERROR_INVALID_SID	O SID não é válido.
ERROR_INVALID_PARAMETER	Um dos parâmetros contém um valor que não é válido. Isso geralmente é um ponteiro que não é válido.

Observações

A função ConvertSidToStringSid usa aS-R padrãoSS... formato para cadeias de caracteres SID. Para obter mais informações sobre a notação de cadeia de caracteres SID, consulte componentes sid.

Nota

O cabeçalho sddl.h define ConvertSidToStringSid como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows XP [aplicativos da área de trabalho \| Aplicativos UWP]
servidor com suporte mínimo	Windows Server 2003 [aplicativos da área de trabalho \| Aplicativos UWP]
da Plataforma de Destino	Windows
cabeçalho	sddl.h
biblioteca	Advapi32.lib
de DLL	Advapi32.dll