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

Requisitos

Consulte também

controle de acesso

funções básicas de controle de acesso

LookupPrivilegeDisplayName

LookupPrivilegeValue