Compartilhar via


Função ConvertSidToStringSidA (sddl.h)

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 de formato de cadeia de caracteres de volta em um SID funcional válido, chame a função ConvertStringSidToSid .

Sintaxe

BOOL ConvertSidToStringSidA(
  [in]  PSID  Sid,
  [out] LPSTR *StringSid
);

Parâmetros

[in] Sid

Um ponteiro para a estrutura 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 retornado

Se a função for bem-sucedida, o valor retornado será diferente de 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. Geralmente, esse é um ponteiro que não é válido.

Comentários

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

Observação

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 de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

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

Confira também

Visão geral do Controle de Acesso

Funções básicas de Controle de Acesso

ConvertSecurityDescriptorToStringSecurityDescriptor

ConvertStringSecurityDescriptorToSecurityDescriptor

ConvertStringSidToSid

SID