Función ZwRollbackEnlistment (wdm.h)
La rutina ZwRollbackEnlistment revierte la transacción asociada a una inscripción especificada.
Sintaxis
NTSYSCALLAPI NTSTATUS ZwRollbackEnlistment(
[in] HANDLE EnlistmentHandle,
[in, optional] PLARGE_INTEGER TmVirtualClock
);
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_SUBORDINATE_RIGHTS acceso al objeto .
[in, optional] TmVirtualClock
Puntero a un valor de reloj virtual. Este parámetro es opcional y puede ser NULL.
Valor devuelto
ZwRollbackEnlistment 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. |
|
No se puede revertir la inscripción. |
|
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 llamar a ZwRollbackEnlistment para revertir una transacción en cualquier momento antes de llamar a ZwPrepareComplete.
Para obtener más información sobre ZwRollbackEnlistment, vea Control de operaciones de reversión.
NtRollbackEnlistment y ZwRollbackEnlistment 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, Ntifs.h) |
| Library | NtosKrnl.lib |
| Archivo DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| Reglas de cumplimiento de DDI | HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm) |
Consulte también
Uso de las versiones Nt y Zw de las rutinas nativas de Servicios del sistema