Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |