Función NtQueryInformationTransactionManager (wdm.h)

Artículo
02/07/2025

La rutina ZwQueryInformationTransactionManager recupera información sobre un objeto de administrador de transacciones especificado.

Sintaxis

__kernel_entry NTSYSCALLAPI NTSTATUS NtQueryInformationTransactionManager(
  [in]            HANDLE                               TransactionManagerHandle,
  [in]            TRANSACTIONMANAGER_INFORMATION_CLASS TransactionManagerInformationClass,
  [out]           PVOID                                TransactionManagerInformation,
  [in]            ULONG                                TransactionManagerInformationLength,
  [out, optional] PULONG                               ReturnLength
);

Parámetros

[in] TransactionManagerHandle

Identificador de un objeto de administrador de transacciones obtenido por una llamada anterior a ZwCreateTransactionManager o ZwOpenTransactionManager. El identificador debe tener TRANSACTIONMANAGER_QUERY_INFORMATION acceso al objeto .

[in] TransactionManagerInformationClass

Valor de enumeración con tipo TRANSACTIONMANAGER_INFORMATION_CLASSque especifica la información que se va a obtener. Este valor debe ser uno de los siguientes:

TransactionManagerBasicInformation
transactionManagerLogInformation
transactionManagerLogPathInformation de

El valor de TransactionManagerOnlineProbeInformation de la enumeración no se usa con ZwQueryInformationTransactionManager.

[out] TransactionManagerInformation

Puntero a un búfer asignado por el autor de la llamada que recibe la información que especifica el parámetro TransactionManagerInformationClass. El tipo de estructura del búfer debe ser TRANSACTIONMANAGER_BASIC_INFORMATION, TRANSACTIONMANAGER_LOG_INFORMATION, TRANSACTIONMANAGER_LOGPATH_INFORMATIONo TRANSACTIONMANAGER_RECOVERY_INFORMATION.

[in] TransactionManagerInformationLength

Longitud, en bytes, del búfer al que apunta el parámetro TransactionManagerInformation , incluida la longitud de cualquier elemento de matriz adicional al que el autor de la llamada haya asignado para recibir información.

[out, optional] ReturnLength

Puntero a una variable asignada por el autor de la llamada que recibe la longitud, en bytes, de la información que KTM escribe en el búfer de TransactionManagerInformation. Este parámetro es opcional y se puede NULL.

Valor devuelto

ZwQueryInformationTransactionManager 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
STATUS_INVALID_INFO_CLASS	El valor del parámetro TransactionManagerInformationClass no es válido.
STATUS_INFO_LENGTH_MISMATCH	La longitud del búfer especificado por el parámetro TransactionManagerInformationLength es incorrecto.
STATUS_OBJECT_TYPE_MISMATCH	El identificador especificado no es un identificador para un objeto de administrador de transacciones.
STATUS_INVALID_HANDLE	Un identificador de objeto no es válido.
STATUS_ACCESS_DENIED	El autor de la llamada no tiene el acceso adecuado al objeto del administrador de transacciones.
STATUS_BUFFER_TOO_SMALL	El búfer especificado por el parámetro TransactionManagerInformation es demasiado pequeño.

La rutina puede devolver otros valores NTSTATUS de .

Observaciones

Para obtener más información sobre cómo usar ZwQueryInformationTransactionManager, vea Using Log Streams with KTM.

NtQueryInformationTransactionManager y ZwQueryInformationTransactionManager 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 NtXxx y Zwversiones de Xxx de una rutina de Servicios del sistema nativo de Windows pueden comportarse 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 de NtXxx y ZwXxx de una rutina, vea Using Nt and Zw Versions of the Native System Services Routines.

Requisitos

Requisito	Valor
cliente mínimo admitido	Disponible en Windows Vista y versiones posteriores del sistema operativo.
de la plataforma de destino de	Universal
encabezado de	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
biblioteca de	NtosKrnl.lib
DLL de	NtosKrnl.exe
irQL	PASSIVE_LEVEL
reglas de cumplimiento de DDI	HwStorPortProhibitedDIs, PowerIrpDDis