Função LookupPrivilegeValueA (winbase.h)
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 |