LsaQueryInformationPolicy-Funktion (ntsecapi.h)

Artikel
02/29/2024

Die LsaQueryInformationPolicy-Funktion ruft Informationen zu einem Policy-Objekt ab.

Syntax

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

Parameter

[in] PolicyHandle

Ein Handle für ein Policy-Objekt . Die erforderlichen Zugriffsrechte für dieses Handle hängen vom Wert des InformationClass-Parameters ab. Weitere Informationen finden Sie unter Öffnen eines Richtlinienobjekthandles.

[in] InformationClass

Gibt einen der folgenden Werte aus dem enumerationstyp POLICY_INFORMATION_CLASS an. Der -Wert gibt den Typ der abzurufenden Informationen an.

Wert	Bedeutung
PolicyAuditEventsInformation	Ruft die Überwachungsregeln des Systems ab. Das im Parameter PolicyHandle übergebene Handle muss über das zugriffsrecht POLICY_VIEW_AUDIT_INFORMATION verfügen. Der Buffer-Parameter empfängt einen Zeiger auf eine POLICY_AUDIT_EVENTS_INFO-Struktur .
PolicyPrimaryDomainInformation	Ruft den Namen und die SID der primären Domäne des Systems ab. Das im Parameter PolicyHandle übergebene Handle muss über das zugriffsrecht POLICY_VIEW_LOCAL_INFORMATION verfügen. Der Buffer-Parameter empfängt einen Zeiger auf eine POLICY_PRIMARY_DOMAIN_INFO-Struktur .
PolicyAccountDomainInformation	Ruft den Namen und die SID der Kontodomäne des Systems ab. Das im Parameter PolicyHandle übergebene Handle muss über das zugriffsrecht POLICY_VIEW_LOCAL_INFORMATION verfügen. Der Buffer-Parameter empfängt einen Zeiger auf eine POLICY_ACCOUNT_DOMAIN_INFO-Struktur .
PolicyLsaServerRoleInformation	Ruft die Rolle eines LSA-Servers ab. Das im Parameter PolicyHandle übergebene Handle muss über das zugriffsrecht POLICY_VIEW_LOCAL_INFORMATION verfügen. Der Parameter Buffer empfängt einen Zeiger auf eine POLICY_LSA_SERVER_ROLE_INFO-Struktur .
PolicyModificationInformation	Ruft Informationen zur Erstellungszeit und zur letzten Änderung der LSA-Datenbank ab. Das im Parameter PolicyHandle übergebene Handle muss über das zugriffsrecht POLICY_VIEW_LOCAL_INFORMATION verfügen. Der Parameter Buffer empfängt einen Zeiger auf eine POLICY_MODIFICATION_INFO-Struktur .
PolicyDnsDomainInformation	Ruft die DNS-Informationen (Domain Name System) über die primäre Domäne ab, die dem Policy-Objekt zugeordnet ist. Das im Parameter PolicyHandle übergebene Handle muss über das zugriffsrecht POLICY_VIEW_LOCAL_INFORMATION verfügen. Der Buffer-Parameter empfängt einen Zeiger auf eine POLICY_DNS_DOMAIN_INFO-Struktur .

[out] Buffer

Zeiger auf eine Variable, die einen Zeiger auf eine Struktur empfängt, die die angeforderten Informationen enthält. Der Typ der Struktur hängt vom Wert des InformationClass-Parameters ab.

Wenn Sie die Informationen nicht mehr benötigen, übergeben Sie den zurückgegebenen Zeiger an LsaFreeMemory.

Rückgabewert

Wenn die LsaQueryInformationPolicy-Funktion erfolgreich ist, wird der Rückgabewert STATUS_SUCCESS.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein NTSTATUS-Code. Weitere Informationen finden Sie unter Rückgabewerte der LSA-Richtlinienfunktion.

Sie können die LsaNtStatusToWinError-Funktion verwenden, um den NTSTATUS-Code in einen Windows-Fehlercode zu konvertieren.

Hinweise

Ein Beispiel, das den Aufruf dieser Funktion veranschaulicht, finden Sie unter Verwalten von Richtlinieninformationen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	ntsecapi.h
Bibliothek	Advapi32.lib
DLL	Advapi32.dll