LsaQueryInformationPolicy-Funktion (ntsecapi.h)
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 |
|---|---|
|
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 . |
|
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 . |
|
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 . |
|
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 . |
|
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 . |
|
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 |