Função LookupPrivilegeNameA (winbase.h)

A função LookupPrivilegeName recupera o nome que corresponde ao privilégio representado em um sistema específico por um LUID ( identificador local exclusivo ) especificado.

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 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.

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 LookupPrivilegeName 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.

Observação

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 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

LookupPrivilegeValue