Funzione NtQueryInformationTransactionManager (wdm.h)

Articolo
02/27/2024

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

Sintassi

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

Parametri

[in] TransactionManagerHandle

Handle a 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 del 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 transaction manager.
STATUS_INVALID_HANDLE	Un handle oggetto non è valido.
STATUS_ACCESS_DENIED	Il chiamante non dispone dell'accesso appropriato all'oggetto 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 sull'uso di ZwQueryInformationTransactionManager, vedere Uso di Flussi di log con KTM.

NtQueryInformationTransactionManager e ZwQueryInformationTransactionManager sono due versioni della stessa routine di Windows Native System Services.

Per le chiamate dai driver in modalità kernel, le versioni NtXxx e ZwXxx di una routine di Windows Native System Services 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 Uso di nt e zw versioni delle routine di Servizi di sistema nativo.

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, PowerIrpDDis