Função LookupAccountSidLocalW (winbase.h)

Artigo
08/27/2023

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

Sintaxe

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

Parâmetros

[in] Sid

Um ponteiro para o SID pesquisar.

[out, optional] Name

Um ponteiro para um buffer que recebe uma cadeia de caracteres terminada em nulo que contém o nome da conta que corresponde ao parâmetro lpSid .

[in, out] cchName

Na entrada, especifica o tamanho, em TCHARs, 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 nulo de terminação.

[out, optional] ReferencedDomainName

Um ponteiro para um buffer que recebe uma cadeia de caracteres terminada em nulo 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 (barras invertidas são excluídas). 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 TCHARs, 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 nulo de terminação.

[out] peUse

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

Retornar valor

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.

Comentários

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

Observação

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 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 [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	winbase.h (inclua Windows.h)