Função LookupAccountSidLocalA (winbase.h)

Artigo
11/20/2024

LookupAccountSidLocalA é definido como uma macro que chama LookupAccountSidA com NULL como o primeiro parâmetro. Recupera o nome da conta para o SID especificado no computador local.

Sintaxe

BOOL LookupAccountSidLocalA(
  [in]            PSID          Sid,
  [out, optional] LPSTR         Name,
  [in, out]       LPDWORD       cchName,
  [out, optional] LPSTR         ReferencedDomainName,
  [in, out]       LPDWORD       cchReferencedDomainName,
  [out]           PSID_NAME_USE peUse
);

Parâmetros

[in] Sid

Um ponteiro para o SID para pesquisar.

[out, optional] Name

Um ponteiro para um buffer que recebe um cadeia de caracteresterminada nula que contém o nome da conta que corresponde ao parâmetro lpSid.

[in, out] cchName

Na entrada, especifica o tamanho, em TCHAR, do buffer lpName . Se a função falhar porque o buffer é muito pequeno ou se cchName for zero, cchName receberá o tamanho do buffer necessário, incluindo o caractere de nulo terminação.

[out, optional] ReferencedDomainName

Um ponteiro para um buffer que recebe um cadeia de caracteresterminada nula que contém o nome do domínio em que o nome da conta foi encontrado.

Em um servidor, o nome de domínio retornado para a maioria das contas no banco de dados de segurança do computador local é o nome do domínio para o qual o servidor é um controlador de domínio.

Em uma estação de trabalho, o nome de domínio retornado para a maioria das contas no banco de dados de segurança do computador local é o nome do computador a partir do último início do sistema (os backslashes são excluídos). Se o nome do computador for alterado, o nome antigo continuará a ser retornado como o nome de domínio até que o sistema seja reiniciado.

Algumas contas são predefinidas pelo sistema. O nome de domínio retornado para essas contas é BUILTIN.

[in, out] cchReferencedDomainName

Na entrada, especifica o tamanho, em TCHAR, do buffer lpReferencedDomainName. Se a função falhar porque o buffer é muito pequeno ou se cchReferencedDomainName for zero, cchReferencedDomainName receberá o tamanho do buffer necessário, incluindo o caractere de nulo.

[out] peUse

Um ponteiro para uma variável que recebe um valor SID_NAME_USE que indica o tipo da conta.

Valor de retorno

Se a função for bem-sucedida, a função retornará diferente de zero.

Se a função falhar, ela retornará zero. Para obter informações de erro estendidas, chame GetLastError.

Observações

Essa função é semelhante a LookupAccountSid, mas restringe a pesquisa ao computador local.

Nota

O cabeçalho winbase.h define LookupAccountSidLocal 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 [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	winbase.h (inclua Windows.h)