Función FltGetTransactionContext (fltkernel.h)

La rutina FltGetTransactionContext recupera un contexto establecido para una transacción mediante un controlador de minifiltro determinado.

Sintaxis

NTSTATUS FLTAPI FltGetTransactionContext(
  [in]  PFLT_INSTANCE Instance,
  [in]  PKTRANSACTION Transaction,
  [out] PFLT_CONTEXT  *Context
);

Parámetros

[in] Instance

Puntero de instancia opaco para el autor de la llamada.

[in] Transaction

Puntero de transacción opaco para la transacción cuyo contexto se está recuperando.

[out] Context

Puntero a una variable asignada por el autor de la llamada que recibe la dirección del contexto de transacción.

Valor devuelto

fltGetTransactionContext devuelve STATUS_SUCCESS o un valor NTSTATUS adecuado, como el siguiente:

Observaciones

Para obtener más información sobre los contextos, vea Acerca de los contextos de minifiltro.

FltGetTransactionContext incrementa el recuento de referencias en el contexto al que apunta el parámetro Context de. Cuando este puntero de contexto ya no es necesario, el autor de la llamada debe disminuir su recuento de referencias llamando a FltReleaseContext. Por lo tanto, cada llamada correcta a fltGetTransactionContext debe coincidir con una llamada posterior a FltReleaseContext.

Para establecer un contexto para una transacción, llame a FltSetTransactionContext.

Para asignar un nuevo contexto de transacción, llame a FltAllocateContext.

Para eliminar un contexto de transacción, llame a FltDeleteTransactionContext o FltDeleteContext.

Requisitos

Consulte también

fltAllocateContext

FltCommitComplete

fltDeleteContext

fltDeleteTransactionContext

FltEnlistInTransaction

fltPreprepareComplete

fltPrepareComplete

fltReleaseContext

fltRollbackComplete

FltRollbackEnlistment

fltSetTransactionContext