LsaQueryDomainInformationPolicy function (ntsecapi.h)

Article
02/22/2024

The LsaQueryDomainInformationPolicy function retrieves domain information from the Policy object.

Syntax

NTSTATUS LsaQueryDomainInformationPolicy(
  [in]  LSA_HANDLE                      PolicyHandle,
  [in]  POLICY_DOMAIN_INFORMATION_CLASS InformationClass,
  [out] PVOID                           *Buffer
);

Parameters

[in] PolicyHandle

A handle to the Policy object for the system.

[in] InformationClass

POLICY_DOMAIN_INFORMATION_CLASS enumeration that specifies the information to be returned from the Policy object. The following table shows the possible values.

Value	Meaning
PolicyDomainEfsInformation	The information is for Encrypting File System.
PolicyDomainKerberosTicketInformation	The information is for a Kerberos ticket.

[out] Buffer

Pointer to a buffer that receives the requested information.

Return value

If the function succeeds, the return value is STATUS_SUCCESS.

If the function fails, the return value is an NTSTATUS code, which can be the following value or one of the LSA Policy Function Return Values.

Return code/value	Description
STATUS_INTERNAL_DB_CORRUPTION	The policy database is corrupt. The returned policy information is not valid for the given class.

Remarks

The POLICY_VIEW_LOCAL_INFORMATION access type is required to retrieve domain information from the Policy object. For more information, see Policy Object Access Rights.

Requirements

Requirement	Value
Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Target Platform	Windows
Header	ntsecapi.h
Library	Advapi32.lib
DLL	Advapi32.dll

Share via