Função NtQueryInformationTransactionManager (wdm.h)

Artigo
08/08/2023

A rotina ZwQueryInformationTransactionManager recupera informações sobre um objeto do gerenciador de transações especificado.

Sintaxe

__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

Um identificador para um objeto do gerenciador de transações que foi obtido por uma chamada anterior para ZwCreateTransactionManager ou ZwOpenTransactionManager. O identificador deve ter TRANSACTIONMANAGER_QUERY_INFORMATION acesso ao objeto .

[in] TransactionManagerInformationClass

Um valor de enumeração de tipo TRANSACTIONMANAGER_INFORMATION_CLASS que especifica as informações a serem obtidas. O valor precisa ser um dos seguintes:

TransactionManagerBasicInformation
TransactionManagerLogInformation
TransactionManagerLogPathInformation

O valor TransactionManagerOnlineProbeInformation da enumeração não é usado com ZwQueryInformationTransactionManager.

[out] TransactionManagerInformation

Um ponteiro para um buffer alocado pelo chamador que recebe as informações especificadas pelo parâmetro TransactionManagerInformationClass . O tipo de estrutura do buffer deve ser TRANSACTIONMANAGER_BASIC_INFORMATION, TRANSACTIONMANAGER_LOG_INFORMATION, TRANSACTIONMANAGER_LOGPATH_INFORMATION ou TRANSACTIONMANAGER_RECOVERY_INFORMATION.

[in] TransactionManagerInformationLength

O comprimento, em bytes, do buffer para o qual o parâmetro TransactionManagerInformation aponta, incluindo o comprimento de quaisquer elementos de matriz adicionais que o chamador tenha alocado para receber informações.

[out, optional] ReturnLength

Um ponteiro para uma variável alocada pelo chamador que recebe o comprimento, em bytes, das informações que o KTM grava no buffer TransactionManagerInformation . Esse parâmetro é opcional e pode ser NULL.

Retornar valor

ZwQueryInformationTransactionManager retornará STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, essa rotina pode retornar um dos seguintes valores:

Código de retorno	Descrição
STATUS_INVALID_INFO_CLASS	O valor do parâmetro TransactionManagerInformationClass é inválido.
STATUS_INFO_LENGTH_MISMATCH	O comprimento do buffer especificado pelo parâmetro TransactionManagerInformationLength está incorreto.
STATUS_OBJECT_TYPE_MISMATCH	O identificador especificado não é um identificador para um objeto do gerenciador de transações.
STATUS_INVALID_HANDLE	Um identificador de objeto é inválido.
STATUS_ACCESS_DENIED	O chamador não tem acesso apropriado ao objeto do gerenciador de transações.
STATUS_BUFFER_TOO_SMALL	O buffer especificado pelo parâmetro TransactionManagerInformation é muito pequeno.

A rotina pode retornar outros valores NTSTATUS.

Comentários

Para obter mais informações sobre como usar ZwQueryInformationTransactionManager, consulte Usando fluxos de log com KTM.

NtQueryInformationTransactionManager e ZwQueryInformationTransactionManager são duas versões da mesma rotina dos Serviços de Sistema Nativo do Windows.

Para chamadas de drivers de modo kernel, as versões NtXxx e ZwXxx de uma rotina do Windows Native System Services podem se comportar de forma diferente na maneira como lidam e interpretam parâmetros de entrada. Para obter mais informações sobre a relação entre as versões NtXxx e ZwXxx de uma rotina, consulte Using Nt and Zw Versions of the Native System Services Routines.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível no Windows Vista e versões posteriores do sistema operacional.
Plataforma de Destino	Universal
Cabeçalho	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Biblioteca	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Regras de conformidade da DDI	HwStorPortProhibitedDDIs, PowerIrpDDis