This topic has not yet been rated - Rate this topic

ZwSetInformationTransaction routine

The ZwSetInformationTransaction routine sets information for a specified transaction.

Syntax


NTSTATUS ZwSetInformationTransaction(
  _In_  HANDLE TransactionHandle,
  _In_  TRANSACTION_INFORMATION_CLASS TransactionInformationClass,
  _In_  PVOID TransactionInformation,
  _In_  ULONG TransactionInformationLength
);

Parameters

TransactionHandle [in]: A handle to a transaction object that was obtained by a previous call to ZwCreateTransaction or ZwOpenTransaction. The handle must have TRANSACTION_SET_INFORMATION access to the object.
TransactionInformationClass [in]: A TRANSACTION_INFORMATION_CLASS-typed value that specifies the type of information to set. The value must be TransactionPropertiesInformation.
TransactionInformation [in]: A pointer to a caller-allocated buffer that contains the information to set. The buffer's structure type must be TRANSACTION_PROPERTIES_INFORMATION.
TransactionInformationLength [in]: The length, in bytes, of the buffer that the TransactionInformation parameter points to.

Return value

ZwSetInformationTransaction returns STATUS_SUCCESS if the operation succeeds. Otherwise, this routine might return one of the following values:

Return code	Description
STATUS_INVALID_INFO_CLASS	The TransactionInformationClass parameter's value is invalid.
STATUS_OBJECT_TYPE_MISMATCH	The handle that the TransactionHandle parameter specifies is not a handle to a transaction object.
STATUS_INVALID_HANDLE	An object handle is invalid.
STATUS_ACCESS_DENIED	The caller does not have appropriate access to the transaction object.
STATUS_INFO_LENGTH_MISMATCH	The TransactionInformationLength parameter's value is invalid.
STATUS_INVALID_PARAMETER	The contents of the buffer that the TransactionInformation buffer specifies is invalid.

The routine might return other NTSTATUS values.

Remarks

For more information about ZwSetInformationTransaction, see Creating a Transactional Client.

Requirements