Funzione NtSetInformationTransaction (wdm.h)

Articolo
02/27/2024

La routine ZwSetInformationTransaction imposta informazioni per una transazione specificata.

Sintassi

__kernel_entry NTSYSCALLAPI NTSTATUS NtSetInformationTransaction(
  [in] HANDLE                        TransactionHandle,
  [in] TRANSACTION_INFORMATION_CLASS TransactionInformationClass,
  [in] PVOID                         TransactionInformation,
  [in] ULONG                         TransactionInformationLength
);

Parametri

[in] TransactionHandle

Handle a un oggetto transazione ottenuto da una chiamata precedente a ZwCreateTransaction o ZwOpenTransaction. L'handle deve avere TRANSACTION_SET_INFORMATION accesso all'oggetto.

[in] TransactionInformationClass

Valore TRANSACTION_INFORMATION_CLASS tipizzato che specifica il tipo di informazioni da impostare. Il valore deve essere TransactionPropertiesInformation.

[in] TransactionInformation

Puntatore a un buffer allocato dal chiamante che contiene le informazioni da impostare. Il tipo di struttura del buffer deve essere TRANSACTION_PROPERTIES_INFORMATION.

[in] TransactionInformationLength

Lunghezza, in byte, del buffer a cui punta il parametro TransactionInformation .

Valore restituito

ZwSetInformationTransaction 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 TransactionInformationClass non è valido.
STATUS_OBJECT_TYPE_MISMATCH	L'handle specificato dal parametro TransactionHandle non è un handle per un oggetto transazione.
STATUS_INVALID_HANDLE	Un handle oggetto non è valido.
STATUS_ACCESS_DENIED	Il chiamante non dispone dell'accesso appropriato all'oggetto transazione.
STATUS_INFO_LENGTH_MISMATCH	Il valore del parametro TransactionInformationLength non è valido.
STATUS_INVALID_PARAMETER	Il contenuto del buffer specificato dal buffer TransactionInformation non è valido.

La routine potrebbe restituire altri valori NTSTATUS.

Commenti

Per altre informazioni su ZwSetInformationTransaction, vedere Creazione di un client transazionale.

NtSetInformationTransaction e ZwSetInformationTransaction 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