NtQueryInformationEnlistment-Funktion (wdm.h)

Artikel
02/07/2025

Die ZwQueryInformationEnlistment Routine ruft Informationen zu einem angegebenen Enlistment-Objektab.

Syntax

__kernel_entry NTSYSCALLAPI NTSTATUS NtQueryInformationEnlistment(
  [in]            HANDLE                       EnlistmentHandle,
  [in]            ENLISTMENT_INFORMATION_CLASS EnlistmentInformationClass,
  [out]           PVOID                        EnlistmentInformation,
  [in]            ULONG                        EnlistmentInformationLength,
  [out, optional] PULONG                       ReturnLength
);

Parameter

[in] EnlistmentHandle

Ein Handle zu einem Enlistment-Objekt, das durch einen vorherigen Aufruf von ZwCreateEnlistment oder ZwOpenEnlistmentabgerufen wurde. Das Handle muss über ENLISTMENT_QUERY_INFORMATION Zugriff auf das Objekt verfügen.

[in] EnlistmentInformationClass

Ein ENLISTMENT_INFORMATION_CLASS-typed-Enumerationswert, der die zu erhaltenden Informationen angibt. Dieser Wert muss einer der folgenden Werte sein:

EnlistmentBasicInformation
EnlistmentRecoveryInformation

Der EnlistmentFullInformation- Wert der Enumeration wird nicht mit ZwQueryInformationEnlistment-verwendet.

[out] EnlistmentInformation

Ein Zeiger auf einen vom Aufrufer zugewiesenen Puffer, der die Informationen empfängt, die der EnlistmentInformationClass Parameter angibt. Wenn der Wert des EnlistmentInformationClass Parameters EnlistmentBasicInformationist, muss der Strukturtyp dieses Puffers ENLISTMENT_BASIC_INFORMATIONwerden. Wenn der Wert des EnlistmentInformationClass Parameter EnlistmentRecoveryInformationist, muss der Typ dieses Puffers mit dem benutzerdefinierten Typ übereinstimmen, den der Aufrufer beim Aufrufen ZwSetInformationEnlistmentverwendet hat.

[in] EnlistmentInformationLength

Die Länge des Puffers, auf den der EnlistmentInformation Parameter verweist.

[out, optional] ReturnLength

Ein Zeiger auf eine vom Aufrufer zugewiesene Variable, die die Länge (in Byte) der Informationen empfängt, die KTM in den EnlistmentInformation Puffer schreibt. Dieser Parameter ist optional und kann NULL-werden.

Rückgabewert

ZwQueryInformationEnlistment gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt diese Routine möglicherweise einen der folgenden Werte zurück:

Rückgabecode	Beschreibung
STATUS_OBJECT_TYPE_MISMATCH	Das angegebene Handle ist kein Handle für ein Enlistment-Objekt.
STATUS_INVALID_HANDLE	Das Objekthandle ist ungültig.
STATUS_INVALID_INFO_CLASS	Der Wert des EnlistmentInformationClass Parameters ist ungültig.
STATUS_INFO_LENGTH_MISMATCH	Der Wert des EnlistmentInformationLength Parameters ist ungültig.
STATUS_ACCESS_DENIED	Der Aufrufer hat keinen geeigneten Zugriff auf das Enlistment-Objekt.

Die Routine gibt möglicherweise andere NTSTATUS-Wertezurück.

Bemerkungen

Ein Ressourcenmanager kann ZwSetInformationEnlistment- aufrufen, um enlistmentspezifische Wiederherstellungsinformationen für ein Enlistment-Objekt festzulegen, und dann ZwQueryInformationEnlistment- aufrufen, um die Wiederherstellungsinformationen abzurufen.

Weitere Informationen zu ZwQueryInformationEnlistment-finden Sie unter Behandeln von Wiederherstellungsvorgängen.

Aufrufer von ZwQueryInformationEnlistment- müssen unter IRQL = PASSIVE_LEVEL ausgeführt werden.

NtQueryInformationEnlistment und ZwQueryInformationEnlistment sind zwei Versionen derselben Windows Native System Services-Routine.

Bei Aufrufen von Kernelmodustreibern können sich die NtXxx und ZwXxx- Versionen einer Windows Native System Services-Routine anders verhalten, wie sie Eingabeparameter behandeln und interpretieren. Weitere Informationen zur Beziehung zwischen den NtXxx und ZwXxx- Versionen einer Routine finden Sie unter Using Nt and Zw Versions of the Native System Services Routines.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar in Windows Vista und höheren Betriebssystemversionen.
Zielplattform-	Universal
Header-	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Library	NtosKrnl.lib
DLL-	NtosKrnl.exe
IRQL-	PASSIVE_LEVEL
DDI-Complianceregeln	HwStorPortProhibitedDIs, PowerIrpDDis