ZwSetInformationEnlistment-Funktion (wdm.h)
Die ZwSetInformationEnlistment-Routine legt Informationen für ein angegebenes Enlistment-Objekt fest.
Syntax
NTSYSCALLAPI NTSTATUS ZwSetInformationEnlistment(
[in] HANDLE EnlistmentHandle,
[in] ENLISTMENT_INFORMATION_CLASS EnlistmentInformationClass,
[in] PVOID EnlistmentInformation,
[in] ULONG EnlistmentInformationLength
);
Parameter
[in] EnlistmentHandle
Ein Handle für ein Enlistment-Objekt, das durch einen vorherigen Aufruf von ZwCreateEnlistment oder ZwOpenEnlistment abgerufen wurde. Das Handle muss ENLISTMENT_SET_INFORMATION Zugriff auf das Objekt haben.
[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 zugewiesenen Puffer, der vom Aufrufer definierte Wiederherstellungsinformationen für die Aufnahme enthält.
[in] EnlistmentInformationLength
Die Länge des Puffers in Bytes, auf den der Parameter EnlistmentInformation 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 |
|---|---|
|
Das angegebene Handle ist kein Handle für ein Einlistungsobjekt. |
|
Das Objekthandle ist ungültig. |
|
Der Wert des Parameters EnlistmentInformationClass ist ungültig. |
|
Der Wert des Parameters EnlistmentInformationLength ist ungültig. |
|
Der Aufrufer hat keinen entsprechenden Zugriff auf das Einlistungsobjekt. |
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 Protokollstreams 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, da 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 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 | HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm) |