Função LookupPrivilegeNameA (winbase.h)
A função
Sintaxe
BOOL LookupPrivilegeNameA(
[in, optional] LPCSTR lpSystemName,
[in] PLUID lpLuid,
[out, optional] LPSTR lpName,
[in, out] LPDWORD cchName
);
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] lpLuid
Um ponteiro para o LUID pelo qual o privilégio é conhecido no sistema de destino.
[out, optional] lpName
Um ponteiro para um buffer que recebe uma cadeia de caracteres terminada em nulo que representa o nome do privilégio. Por exemplo, essa cadeia de caracteres pode ser "SeSecurityPrivilege".
[in, out] cchName
Um ponteiro para uma variável que especifica o tamanho, em um valor de TCHAR, do buffer lpName. Quando a função retorna, esse parâmetro contém o comprimento do nome do privilégio, não incluindo o caractere nulo de terminação. Se o buffer apontado pelo parâmetro lpName for muito pequeno, essa variável conterá o tamanho necessário.
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 LookupPrivilegeName 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.
Nota
O cabeçalho winbase.h define LookupPrivilegeName 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 |