Hardware Dev Center

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 codeDescription
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

Target platform

Universal

Version

Available in Windows Vista and later operating system versions.

Header

Wdm.h (include Wdm.h, Ntddk.h, or Ntifs.h)

Library

NtosKrnl.lib

DLL

NtosKrnl.exe

IRQL

PASSIVE_LEVEL

DDI compliance rules

PowerIrpDDis, HwStorPortProhibitedDDIs

See also

TRANSACTION_INFORMATION_CLASS
TRANSACTION_PROPERTIES_INFORMATION
ZwCreateTransaction
ZwOpenTransaction
ZwQueryInformationTransaction

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft