Función TmReadOnlyEnlistment (wdm.h)
La rutina TmReadOnlyEnlistment establece que una inscripción especificada sea de solo lectura.
Sintaxis
NTSTATUS TmReadOnlyEnlistment(
[in] PKENLISTMENT Enlistment,
[in] PLARGE_INTEGER TmVirtualClock
);
Parámetros
[in] Enlistment
Puntero a un objeto de inscripción. El componente puede recibir este puntero como entrada en una rutina de devolución de llamada ResourceManagerNotification . Como alternativa, el componente puede llamar a ObReferenceObjectByHandle y proporcionar el identificador del objeto que proporcionó una llamada anterior a ZwCreateEnlistment, TmCreateEnlistment o ZwOpenEnlistment proporcionada.
[in] TmVirtualClock
Puntero a un valor de reloj virtual. Este parámetro es opcional y puede ser NULL.
Valor devuelto
TmReadOnlyEnlistment 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 |
|---|---|
|
La transacción o su inscripción no está en el estado correcto. Por ejemplo, una inscripción no puede ser de solo lectura si la marca de ENLISTMENT_SUPERIOR se especificó en ZwCreateEnlistment. |
La rutina podría devolver otros valores NTSTATUS.
Comentarios
La rutina TmReadOnlyEnlistment es una versión basada en puntero de la rutina ZwReadOnlyEnlistment .
Para obtener información sobre cuándo usar las rutinas TmXxx de KTM en lugar de las rutinas ZwXxx , consulte Uso de rutinas TmXxx.
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 |