Función NtSetInformationEnlistment (wdm.h)
La rutina ZwSetInformationEnlistment establece información para un objeto de inscripción especificado.
Sintaxis
__kernel_entry NTSYSCALLAPI NTSTATUS NtSetInformationEnlistment(
[in] HANDLE EnlistmentHandle,
[in] ENLISTMENT_INFORMATION_CLASS EnlistmentInformationClass,
[in] PVOID EnlistmentInformation,
[in] ULONG EnlistmentInformationLength
);
Parámetros
[in] EnlistmentHandle
Identificador de un objeto de inscripción obtenido por una llamada anterior a ZwCreateEnlistment o ZwOpenEnlistment. El identificador debe tener ENLISTMENT_SET_INFORMATION acceso al objeto .
[in] EnlistmentInformationClass
Valor de enumeración con tipo ENLISTMENT_INFORMATION_CLASS que especifica el tipo de información que se va a establecer. Este valor debe ser EnlistmentRecoveryInformation.
Los valores EnlistmentBasicInformation y EnlistmentFullInformation de la enumeración no se usan con ZwSetInformationEnlistment.
[in] EnlistmentInformation
Puntero a un búfer asignado por el autor de la llamada que contiene información de recuperación definida por el autor de la llamada para la inscripción.
[in] EnlistmentInformationLength
Longitud, en bytes, del búfer al que apunta el parámetro EnlistmentInformation .
Valor devuelto
ZwSetInformationEnlistment devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, esta rutina podría devolver uno de los siguientes valores:
| Código devuelto | Descripción |
|---|---|
|
El identificador especificado no es un identificador para un objeto de inscripción. |
|
El identificador de objeto no es válido. |
|
El valor del parámetro EnlistmentInformationClass no es válido. |
|
El valor del parámetro EnlistmentInformationLength no es válido. |
|
El autor de la llamada no tiene el acceso adecuado al objeto de inscripción. |
La rutina podría devolver otros valores NTSTATUS.
Comentarios
Un administrador de recursos puede usar la rutina ZwSetInformationEnlistment para establecer información de recuperación para una inscripción. KTM escribe la información de recuperación en el flujo de registro y el administrador de recursos puede llamar a ZwQueryInformationEnlistment para leer esta información de la secuencia de registro en cualquier momento.
Cada llamada posterior a ZwSetInformationEnlistment elimina la información de recuperación que la llamada anterior especificó antes de almacenar la nueva información de recuperación.
Para obtener más información sobre cómo usar ZwSetInformationEnlistment, consulte Uso de secuencias de registro con KTM.
NtSetInformationEnlistment y ZwSetInformationEnlistment son dos versiones de la misma rutina de Servicios del sistema nativo de Windows.
En el caso de las llamadas desde controladores en modo kernel, las versiones NtXxx y ZwXxx de una rutina de Servicios del sistema nativo de Windows se pueden comportar de forma diferente en la forma en que controlan e interpretan los parámetros de entrada. Para obtener más información sobre la relación entre las versiones NtXxx y ZwXxx de una rutina, vea Using Nt and Zw Versions of the Native System Services Routines.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Windows Vista y versiones posteriores del sistema operativo. |
| Plataforma de destino | Universal |
| Encabezado | wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h) |
| Library | NtosKrnl.lib |
| Archivo DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| Reglas de cumplimiento de DDI | HwStorPortProhibitedDIs, PowerIrpDDis |
Consulte también
Uso de las versiones Nt y Zw de las rutinas nativas de Servicios del sistema