Freigeben über


NtQueryInformationEnlistment-Funktion (wdm.h)

Die ZwQueryInformationEnlistment-Routine ruft Informationen zu einem angegebenen Eintragsobjekt ab.

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 für ein Eintragsobjekt, das durch einen vorherigen Aufruf von ZwCreateEnlistment oder ZwOpenEnlistment abgerufen wurde. Das Handle muss über ENLISTMENT_QUERY_INFORMATION Zugriff auf das Objekt verfügen.

[in] EnlistmentInformationClass

Ein ENLISTMENT_INFORMATION_CLASS typisierter 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 zugeordneten Puffer, der die Vom EnlistmentInformationClass-Parameter angegebenen Informationen empfängt. Wenn der Wert des EnlistmentInformationClass-ParametersEnlistmentBasicInformation lautet, muss der Strukturtyp dieses Puffers ENLISTMENT_BASIC_INFORMATION sein. Wenn der Wert des EnlistmentInformationClass-ParametersEnlistmentRecoveryInformation lautet, muss der Typ dieses Puffers mit dem vom Aufrufer definierten Typ übereinstimmen, den der Aufrufer beim Aufrufen von ZwSetInformationEnlistment verwendet hat.

[in] EnlistmentInformationLength

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

[out, optional] ReturnLength

Ein Zeiger auf eine vom Aufrufer zugeordnete Variable, die die Länge der Informationen in Bytes empfängt, die KTM in den Puffer EnlistmentInformation schreibt. Dieser Parameter ist optional und kann NULL sein.

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 Eintragsobjekt.
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 Eintragsobjekt.
 

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

Hinweise

Ein Ressourcen-Manager 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 verarbeiten und interpretieren. Weitere Informationen zur Beziehung zwischen den Nt Xxx- und ZwXxx-Versionen einer Routine finden Sie unter Verwenden von Nt- und Zw-Versionen der systemeigenen Systemdienstroutinen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Windows Vista und höheren Betriebssystemversionen.
Zielplattform Universell
Header wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
Bibliothek NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
DDI-Complianceregeln HwStorPortProhibitedDIs, PowerIrpDDis

Weitere Informationen

ENLISTMENT_BASIC_INFORMATION

ENLISTMENT_INFORMATION_CLASS

Verwenden von Nt- und Zw-Versionen der Systemdienstroutinen

ZwCreateEnlistment

ZwOpenEnlistment

ZwSetInformationEnlistment