Função LsaQueryInformationPolicy (ntsecapi.h)

Artigo
03/13/2024

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