Função LookupPrivilegeValueA (winbase.h)

  • Artigo

A função LookupPrivilegeValue recupera o LUID ( identificador local exclusivo ) usado em um sistema especificado para representar localmente o nome do privilégio especificado.

Sintaxe

BOOL LookupPrivilegeValueA(
  [in, optional] LPCSTR lpSystemName,
  [in]           LPCSTR lpName,
  [out]          PLUID  lpLuid
);

Parâmetros

[in, optional] lpSystemName

Um ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome do sistema no qual o nome do privilégio é recuperado. Se uma cadeia de caracteres nula for especificada, a função tentará localizar o nome do privilégio no sistema local.

[in] lpName

Um ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome do privilégio, conforme definido no arquivo de cabeçalho Winnt.h. Por exemplo, esse parâmetro pode especificar a constante, SE_SECURITY_NAME ou sua cadeia de caracteres correspondente, "SeSecurityPrivilege".

[out] lpLuid

Um ponteiro para uma variável que recebe o LUID pelo qual o privilégio é conhecido no sistema especificado pelo parâmetro lpSystemName .

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

A função LookupPrivilegeValue dá suporte apenas aos privilégios especificados na seção Privilégios Definidos de Winnt.h. Para obter uma lista de valores, consulte Constantes de privilégios.

Exemplos

Para obter um exemplo que usa essa função, consulte Habilitando e desabilitando privilégios.

Observação

O cabeçalho winbase.h define LookupPrivilegeValue 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 winbase.h (inclua Windows.h)
Biblioteca Advapi32.lib
DLL Advapi32.dll

Confira também

Controle de acesso

Funções de Controle de Acesso básicas

LookupPrivilegeDisplayName

LookupPrivilegeName