Função LookupPrivilegeDisplayNameW (winbase.h)

A função LookupPrivilegeDisplayName recupera o nome de exibição que representa um privilégio especificado.

Sintaxe

BOOL LookupPrivilegeDisplayNameW(
  [in, optional]  LPCWSTR lpSystemName,
  [in]            LPCWSTR lpName,
  [out, optional] LPWSTR  lpDisplayName,
  [in, out]       LPDWORD cchDisplayName,
  [out]           LPDWORD lpLanguageId
);

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 de exibição no sistema local.

[in] lpName

Um ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome do privilégio, conforme definido em Winnt.h. Por exemplo, esse parâmetro pode especificar a constante, SE_REMOTE_SHUTDOWN_NAME ou sua cadeia de caracteres correspondente, "SeRemoteShutdownPrivilege". Para obter uma lista de valores, consulte Constantes de privilégio.

[out, optional] lpDisplayName

Um ponteiro para um buffer que recebe uma cadeia de caracteres terminada em nulo que especifica o nome de exibição do privilégio. Por exemplo, se o parâmetro lpName for SE_REMOTE_SHUTDOWN_NAME, o nome de exibição do privilégio será "Forçar desligamento de um sistema remoto".

[in, out] cchDisplayName

Um ponteiro para uma variável que especifica o tamanho, em TCHARs, do buffer lpDisplayName . Quando a função retorna, esse parâmetro contém o comprimento do nome de exibição do privilégio, não incluindo o caractere nulo de terminação. Se o buffer apontado pelo parâmetro lpDisplayName for muito pequeno, essa variável conterá o tamanho necessário.

[out] lpLanguageId

Um ponteiro para uma variável que recebe o identificador de idioma para o nome de exibição retornado.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

A função LookupPrivilegeDisplayName recupera nomes de exibição somente para os privilégios especificados na seção Privilégios Definidos de Winnt.h.

Observação

O cabeçalho winbase.h define LookupPrivilegeDisplayName 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 (incluir Windows.h)
Biblioteca Advapi32.lib
DLL Advapi32.dll

Confira também

Visão geral do Controle de Acesso

Funções básicas de Controle de Acesso

LookupPrivilegeName

LookupPrivilegeValue