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