ClfsMgmtQueryPolicy-Funktion (wdm.h)

Artikel
02/07/2025

Die ClfsMgmtQueryPolicy Routine ruft eine bestimmte CLFS_MGMT_POLICY Struktur für ein Protokoll ab.

Syntax

CLFSUSER_API NTSTATUS ClfsMgmtQueryPolicy(
  [in]  PLOG_FILE_OBJECT      LogFile,
  [in]  CLFS_MGMT_POLICY_TYPE PolicyType,
  [out] PCLFS_MGMT_POLICY     Policy,
  [out] PULONG                PolicyLength
);

Parameter

[in] LogFile

Ein Zeiger auf eine LOG_FILE_OBJECT Struktur, die das CLFS-Protokoll darstellt, dessen Richtlinie abgerufen wird.

[in] PolicyType

Ein Wert der CLFS_MGMT_POLICY_TYPE-Aufzählung, die den Typ der abzurufenden Richtlinie identifiziert.

[out] Policy

Eine Instanz der CLFS_MGMT_POLICY Struktur, die die Richtlinie enthält.

[out] PolicyLength

Die Länge des Policy-Parameters.

Rückgabewert

Die ClfsMgmtQueryPolicy Routine gibt einen der folgenden NTSTATUS-Werte zurück:

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die CLFS-Verwaltung hat die angeforderte Richtlinie abgerufen.
STATUS_UNSUCCESSFUL	Die CLFS-Verwaltung konnte die Anforderung nicht verarbeiten.
STATUS_INVALID_PARAMETER	Der Wert des PolicyType--Parameters ist für die CLFS_MGMT_POLICY_TYPE-Aufzählung ungültig.
STATUS_INVALID_PARAMETER_1	Für den parameter LogFile wurde ein NULL- Wert angegeben.
STATUS_INVALID_PARAMETER_2	Der Wert des PolicyLength--Parameters ist kleiner als die Größe einer Instanz der CLFS_MGMT_POLICY-Struktur.
STATUS_INSUFFICIENT_RESOURCES	Es ist nicht genügend Arbeitsspeicher vorhanden, um den Vorgang abzuschließen.
STATUS_LOG_POLICY_NOT_INSTALLED	Für die Protokolldatei wurde keine Richtlinie dieses Typs registriert.

Diese Routine kann auch andere NTSTATUS-Wertezurückgeben.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar in Windows Server 2003 R2, Windows Vista und höheren Versionen von Windows.
Zielplattform-	Desktop
Header-	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Library	Clfs.lib
DLL-	Clfs.sys
IRQL-	<= APC_LEVEL

Siehe auch

CLFS_MGMT_POLICY

CLFS_MGMT_POLICY_TYPE

Freigeben über