Функция NtQueryInformationTransactionManager (wdm.h)

Статья
02/07/2025

Программа ZwQueryInformationTransactionManager извлекает сведения об указанном объекте диспетчера транзакций.

Синтаксис

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

Параметры

[in] TransactionManagerHandle

Дескриптор объекта диспетчера транзакций , который был получен предыдущим вызовом ZwCreateTransactionManager или ZwOpenTransactionManager. Дескриптор должен иметь TRANSACTIONMANAGER_QUERY_INFORMATION доступ к объекту.

[in] TransactionManagerInformationClass

Значение перечисления TRANSACTIONMANAGER_INFORMATION_CLASSтипа, указывающее полученные сведения. Это значение должно быть одним из следующих значений:

TransactionManagerBasicInformation
TransactionManagerLogInformation
TransactionManagerLogPathInformation

Значение TransactionManagerOnlineProbeInformation перечисления не используется с ZwQueryInformationTransactionManager.

[out] TransactionManagerInformation

Указатель на выделенный вызывающим буфером, который получает сведения, которые указывает параметр TransactionManagerInformationClass. Тип структуры буфера должен быть TRANSACTIONMANAGER_BASIC_INFORMATION, TRANSACTIONMANAGER_LOG_INFORMATION, TRANSACTIONMANAGER_LOGPATH_INFORMATIONили TRANSACTIONMANAGER_RECOVERY_INFORMATION.

[in] TransactionManagerInformationLength

Длина буфера в байтах, на который указывает параметр TransactionManager Information, включая длину всех дополнительных элементов массива, выделенных вызывающей функцией для получения информации.

[out, optional] ReturnLength

Указатель на выделенную вызывающим переменную, которая получает длину в байтах информации, записываемой KTM в буфер TransactionManagerInformation. Этот параметр является необязательным и может быть null.

Возвращаемое значение

ZwQueryInformationTransactionManager возвращает STATUS_SUCCESS, если операция выполнена успешно. В противном случае эта подпрограмма может вернуть одно из следующих значений:

Возвращаемый код	Описание
STATUS_INVALID_INFO_CLASS	Значение параметра TransactionManagerInformationClass недопустимо.
STATUS_INFO_LENGTH_MISMATCH	Длина буфера, указанного параметром TransactionManagerInformationLength , является неверным.
STATUS_OBJECT_TYPE_MISMATCH	Указанный дескриптор не является дескриптором объекта диспетчера транзакций.
STATUS_INVALID_HANDLE	Дескриптор объекта недопустим.
STATUS_ACCESS_DENIED	Вызывающий объект не имеет соответствующего доступа к объекту диспетчера транзакций.
STATUS_BUFFER_TOO_SMALL	Буфер, указанный параметром TransactionManagerInformation , слишком мал.

Подпрограмма может возвращать другие значения NTSTATUS .

Замечания

Дополнительные сведения об использовании ZwQueryInformationTransactionManagerсм. в использовании потоков журналов сKTM.

NtQueryInformationTransactionManager и ZwQueryInformationTransactionManager являются двумя версиями одной подпрограммы windows Native System Services.

Для вызовов драйверов в режиме ядра NtXxx и ZwXxx версии подпрограммы Windows Native System Services могут вести себя по-разному в том, как они обрабатывают и интерпретируют входные параметры. Дополнительные сведения о связи между NtXxx и ZwXxx версиями подпрограммы см. в разделе Using Nt and Zw Versions of the Native System Services Routines.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно в Windows Vista и более поздних версиях операционной системы.
целевая платформа	Всеобщий
заголовка	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
библиотеки	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
правил соответствия DDI	HwStorPortProhibitedDDIs, PowerIrpDDis