Função ConvertStringSidToSidA (sddl.h)

Artigo
03/01/2024

A função ConvertStringSidToSid converte um SID ( identificador de segurança ) em um SID válido e funcional. Você pode usar essa função para recuperar um SID que a função ConvertSidToStringSid converteu em formato de cadeia de caracteres.

Sintaxe

BOOL ConvertStringSidToSidA(
  [in]  LPCSTR StringSid,
  [out] PSID   *Sid
);

Parâmetros

[in] StringSid

Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o SID de formato de cadeia de caracteres a ser convertido.

A cadeia de caracteres SID pode usar o S-R-I-S- padrão... formato para cadeias de caracteres SID ou o formato constante de cadeia de caracteres SID, como "BA" para administradores internos. Para obter mais informações sobre a notação de cadeia de caracteres sid, consulte Componentes de SID.

[out] Sid

Um ponteiro para uma variável que recebe um ponteiro para o SID convertido. 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_INVALID_PARAMETER	Parâmetro inválido.
ERROR_INVALID_SID	SID inválido.

Comentários

Observação

O cabeçalho sddl.h define ConvertStringSidToSid 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