NtSetInformationEnlistment-Funktion (wdm.h)

Die ZwSetInformationEnlistment-Routine legt Informationen für ein angegebenes Enlistment-Objekt fest.

Syntax

__kernel_entry NTSYSCALLAPI NTSTATUS NtSetInformationEnlistment(
  [in] HANDLE                       EnlistmentHandle,
  [in] ENLISTMENT_INFORMATION_CLASS EnlistmentInformationClass,
  [in] PVOID                        EnlistmentInformation,
  [in] ULONG                        EnlistmentInformationLength
);

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_SET_INFORMATION Zugriff auf das Objekt verfügen.

[in] EnlistmentInformationClass

Ein ENLISTMENT_INFORMATION_CLASS typisierter Enumerationswert, der den Typ der festzulegenden Informationen angibt. Dieser Wert muss EnlistmentRecoveryInformation sein.

Die Werte EnlistmentBasicInformation und EnlistmentFullInformation der Enumeration werden nicht mit ZwSetInformationEnlistment verwendet.

[in] EnlistmentInformation

Ein Zeiger auf einen vom Aufrufer zugeordneten Puffer, der vom Aufrufer definierte Wiederherstellungsinformationen für die Registrierung enthält.

[in] EnlistmentInformationLength

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

Rückgabewert

ZwSetInformationEnlistment 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 die ZwSetInformationEnlistment-Routine verwenden, um Wiederherstellungsinformationen für eine Registrierung festzulegen. KTM schreibt die Wiederherstellungsinformationen in den Protokolldatenstrom, und der Ressourcen-Manager kann ZwQueryInformationEnlistment aufrufen, um diese Informationen jederzeit aus dem Protokolldatenstrom zu lesen.

Jeder nachfolgende Aufruf von ZwSetInformationEnlistment löscht die Wiederherstellungsinformationen, die der vorherige Aufruf angegeben hat, bevor die neuen Wiederherstellungsinformationen gespeichert werden.

Weitere Informationen zur Verwendung von ZwSetInformationEnlistment finden Sie unter Verwenden von Protokolldatenströmen mit KTM.

NtSetInformationEnlistment und ZwSetInformationEnlistment 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_INFORMATION_CLASS

Verwenden von Nt- und Zw-Versionen der Systemdienstroutinen

ZwCreateEnlistment

ZwOpenEnlistment

ZwQueryInformationEnlistment