Função LookupPrivilegeValueW (winbase.h)
A função LookupPrivilegeValue recupera o LUID ( de identificador localmente exclusivo) usado em um sistema especificado para representar localmente o nome do privilégio especificado.
Sintaxe
BOOL LookupPrivilegeValueW(
[in, optional] LPCWSTR lpSystemName,
[in] LPCWSTR 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.
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
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 Privilege Constants.
Exemplos
Para obter um exemplo que usa essa função, consulte Habilitar e desabilitar privilégios.
Nota
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 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 [aplicativos da área de trabalho | Aplicativos UWP] |
| servidor com suporte mínimo | Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP] |
| da Plataforma de Destino |
Windows |
| cabeçalho | winbase.h (inclua Windows.h) |
| biblioteca | Advapi32.lib |
| de DLL |
Advapi32.dll |