Función ZwQueryInformationTransactionManager (wdm.h)

Artículo
02/27/2024

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

Sintaxis

NTSYSCALLAPI NTSTATUS ZwQueryInformationTransactionManager(
  [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_CLASS que especifica la información que se va a obtener. Este valor debe ser uno de los siguientes:

TransactionManagerBasicInformation
TransactionManagerLogInformation
TransactionManagerLogPathInformation

El valor 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_INFORMATION o TRANSACTIONMANAGER_RECOVERY_INFORMATION.

[in] TransactionManagerInformationLength

Longitud, en bytes, del búfer al que apunta el parámetro TransactionManagerInformation , incluida la longitud de los elementos de matriz adicionales que el autor de la llamada ha 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 TransactionManagerInformation . Este parámetro es opcional y puede ser 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 incorrecta.
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 podría devolver otros valores NTSTATUS.

Comentarios

Para obtener más información sobre cómo usar ZwQueryInformationTransactionManager, consulte Uso de secuencias de registro con KTM.

NtQueryInformationTransactionManager y ZwQueryInformationTransactionManager son dos versiones de la misma rutina de Windows Native System Services.

En el caso de las llamadas desde controladores en modo kernel, las versiones NtXxx y ZwXxx de una rutina de Windows Native System Services 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 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(storport), PowerIrpDDis(wdm)