Funzione ZwQueryInformationTransactionManager (wdm.h)

Articolo
02/27/2024

La routine ZwQueryInformationTransactionManager recupera informazioni su un oggetto di gestione transazioni specificato.

Sintassi

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

Parametri

[in] TransactionManagerHandle

Handle per un oggetto di gestione transazioni ottenuto da una chiamata precedente a ZwCreateTransactionManager o ZwOpenTransactionManager. L'handle deve avere TRANSACTIONMANAGER_QUERY_INFORMATION accesso all'oggetto .

[in] TransactionManagerInformationClass

Valore di enumerazione TRANSACTIONMANAGER_INFORMATION_CLASS tipizzato che specifica le informazioni da ottenere. Questo valore deve essere uno dei seguenti:

TransactionManagerBasicInformation
TransactionManagerLogInformation
TransactionManagerLogPathInformation

Il valore TransactionManagerOnlineProbeInformation dell'enumerazione non viene usato con ZwQueryInformationTransactionManager.

[out] TransactionManagerInformation

Puntatore a un buffer allocato dal chiamante che riceve le informazioni specificate dal parametro TransactionManagerInformationClass . Il tipo di struttura del buffer deve essere TRANSACTIONMANAGER_BASIC_INFORMATION, TRANSACTIONMANAGER_LOG_INFORMATION, TRANSACTIONMANAGER_LOGPATH_INFORMATION o TRANSACTIONMANAGER_RECOVERY_INFORMATION.

[in] TransactionManagerInformationLength

Lunghezza, in byte, del buffer a cui punta il parametro TransactionManagerInformation , inclusa la lunghezza di eventuali elementi di matrice aggiuntivi allocati dal chiamante per ricevere informazioni.

[out, optional] ReturnLength

Puntatore a una variabile allocata dal chiamante che riceve la lunghezza, in byte, delle informazioni che KTM scrive nel buffer TransactionManagerInformation . Questo parametro è facoltativo e può essere NULL.

Valore restituito

ZwQueryInformationTransactionManager restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, questa routine potrebbe restituire uno dei valori seguenti:

Codice restituito	Descrizione
STATUS_INVALID_INFO_CLASS	Il valore del parametro TransactionManagerInformationClass non è valido.
STATUS_INFO_LENGTH_MISMATCH	La lunghezza del buffer specificata dal parametro TransactionManagerInformationLength non è corretta.
STATUS_OBJECT_TYPE_MISMATCH	L'handle specificato non è un handle per un oggetto di gestione transazioni.
STATUS_INVALID_HANDLE	Un handle di oggetto non è valido.
STATUS_ACCESS_DENIED	Il chiamante non dispone dell'accesso appropriato all'oggetto di gestione transazioni.
STATUS_BUFFER_TOO_SMALL	Il buffer specificato dal parametro TransactionManagerInformation è troppo piccolo.

La routine potrebbe restituire altri valori NTSTATUS.

Commenti

Per altre informazioni su come usare ZwQueryInformationTransactionManager, vedi Uso di flussi di log con KTM.

NtQueryInformationTransactionManager e ZwQueryInformationTransactionManager sono due versioni della stessa routine di Servizi di sistema nativi di Windows.

Per le chiamate da driver in modalità kernel, le versioni NtXxx e ZwXxx di una routine di Servizi di sistema nativi di Windows possono comportarsi in modo diverso nel modo in cui gestiscono e interpretano i parametri di input. Per altre informazioni sulla relazione tra le versioni NtXxx e ZwXxx di una routine, vedere Using Nt and Zw Versions of the Native System Services Routines .For more information about the Nt Xxx and Zw versions of the Native System Services Routines.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows Vista e versioni successive del sistema operativo.
Piattaforma di destinazione	Universale
Intestazione	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Libreria	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Regole di conformità DDI	HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)