Compartilhar via


Função LsaQueryInformationPolicy (ntsecapi.h)

A função LsaQueryInformationPolicy recupera informações sobre um objeto Policy .

Sintaxe

NTSTATUS LsaQueryInformationPolicy(
  [in]  LSA_HANDLE               PolicyHandle,
  [in]  POLICY_INFORMATION_CLASS InformationClass,
  [out] PVOID                    *Buffer
);

Parâmetros

[in] PolicyHandle

Um identificador para um objeto Policy . Os direitos de acesso necessários para esse identificador dependem do valor do parâmetro InformationClass . Para obter mais informações, consulte Abrindo um identificador de objeto de política.

[in] InformationClass

Especifica um dos valores a seguir do tipo de enumeração POLICY_INFORMATION_CLASS . O valor indica o tipo de informação a ser recuperado.

Valor Significado
PolicyAuditEventsInformation
Recupera as regras de auditoria do sistema. O identificador passado no parâmetro PolicyHandle deve ter o acesso POLICY_VIEW_AUDIT_INFORMATION correto. O parâmetro Buffer recebe um ponteiro para uma estrutura de POLICY_AUDIT_EVENTS_INFO .
PolicyPrimaryDomainInformation
Recupera o nome e o SID do domínio primário do sistema. O identificador passado no parâmetro PolicyHandle deve ter o acesso POLICY_VIEW_LOCAL_INFORMATION direito. O parâmetro Buffer recebe um ponteiro para uma estrutura de POLICY_PRIMARY_DOMAIN_INFO .
PolicyAccountDomainInformation
Recupera o nome e o SID do domínio da conta do sistema. O identificador passado no parâmetro PolicyHandle deve ter o acesso POLICY_VIEW_LOCAL_INFORMATION direito. O parâmetro Buffer recebe um ponteiro para uma estrutura de POLICY_ACCOUNT_DOMAIN_INFO .
PolicyLsaServerRoleInformation
Recupera a função de um servidor LSA. O identificador passado no parâmetro PolicyHandle deve ter o acesso POLICY_VIEW_LOCAL_INFORMATION direito. O parâmetro Buffer recebe um ponteiro para uma estrutura de POLICY_LSA_SERVER_ROLE_INFO .
PolicyModificationInformation
Recupera informações sobre a hora de criação e a última modificação do banco de dados LSA. O identificador passado no parâmetro PolicyHandle deve ter o acesso POLICY_VIEW_LOCAL_INFORMATION direito. O parâmetro Buffer recebe um ponteiro para uma estrutura de POLICY_MODIFICATION_INFO .
PolicyDnsDomainInformation
Recupera as informações do DNS (Sistema de Nomes de Domínio) sobre o domínio primário associado ao objeto Policy . O identificador passado no parâmetro PolicyHandle deve ter o acesso POLICY_VIEW_LOCAL_INFORMATION direito. O parâmetro Buffer recebe um ponteiro para uma estrutura de POLICY_DNS_DOMAIN_INFO .

[out] Buffer

Ponteiro para uma variável que recebe um ponteiro para uma estrutura que contém as informações solicitadas. O tipo de estrutura depende do valor do parâmetro InformationClass .

Quando você não precisar mais das informações, passe o ponteiro retornado para LsaFreeMemory.

Retornar valor

Se a função LsaQueryInformationPolicy for bem-sucedida, o valor retornado será STATUS_SUCCESS.

Se a função falhar, o valor retornado será um código NTSTATUS. Para obter mais informações, consulte Valores retornados da função de política LSA.

Você pode usar a função LsaNtStatusToWinError para converter o código NTSTATUS em um código de erro do Windows.

Comentários

Para obter um exemplo que demonstra como chamar essa função, consulte Gerenciando informações de política.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho ntsecapi.h
Biblioteca Advapi32.lib
DLL Advapi32.dll

Confira também

LsaFreeMemory

LsaSetInformationPolicy

POLICY_ACCOUNT_DOMAIN_INFO

POLICY_AUDIT_EVENTS_INFO

POLICY_DNS_DOMAIN_INFO

POLICY_INFORMATION_CLASS

POLICY_LSA_SERVER_ROLE_INFO

POLICY_MODIFICATION_INFO

POLICY_PRIMARY_DOMAIN_INFO