Funzione ZwSetInformationTransaction (wdm.h)

Articolo
08/08/2023

La routine ZwSetInformationTransaction imposta le informazioni per una transazione specificata.

Sintassi

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

Parametri

[in] TransactionHandle

Handle per 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 tipizzato TRANSACTION_INFORMATION_CLASS 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 di 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 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)