Función NtSetInformationTransaction (wdm.h)

Artículo
08/08/2023

La rutina ZwSetInformationTransaction establece información para una transacción especificada.

Sintaxis

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

Parámetros

[in] TransactionHandle

Identificador de un objeto de transacción obtenido por una llamada anterior a ZwCreateTransaction o ZwOpenTransaction. El identificador debe tener TRANSACTION_SET_INFORMATION acceso al objeto .

[in] TransactionInformationClass

Valor de tipo TRANSACTION_INFORMATION_CLASS que especifica el tipo de información que se va a establecer. El valor debe ser TransactionPropertiesInformation.

[in] TransactionInformation

Puntero a un búfer asignado por el autor de la llamada que contiene la información que se va a establecer. El tipo de estructura del búfer debe ser TRANSACTION_PROPERTIES_INFORMATION.

[in] TransactionInformationLength

Longitud, en bytes, del búfer al que apunta el parámetro TransactionInformation .

Valor devuelto

ZwSetInformationTransaction devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, esta rutina podría devolver uno de los siguientes valores:

Código devuelto	Descripción
STATUS_INVALID_INFO_CLASS	El valor del parámetro TransactionInformationClass no es válido.
STATUS_OBJECT_TYPE_MISMATCH	El identificador que especifica el parámetro TransactionHandle no es un identificador para un objeto de transacción.
STATUS_INVALID_HANDLE	Un identificador de objeto no es válido.
STATUS_ACCESS_DENIED	El autor de la llamada no tiene el acceso adecuado al objeto de transacción.
STATUS_INFO_LENGTH_MISMATCH	El valor del parámetro TransactionInformationLength no es válido.
STATUS_INVALID_PARAMETER	El contenido del búfer que especifica el búfer TransactionInformation no es válido.

La rutina podría devolver otros valores NTSTATUS.

Comentarios

Para obtener más información sobre ZwSetInformationTransaction, vea Creating a Transactional Client.

NtSetInformationTransaction y ZwSetInformationTransaction son dos versiones de la misma rutina de Windows Native System Services.

En el caso de las llamadas desde controladores en modo kernel, las versiones NtXxx y ZwXxx de una rutina de Windows Native System Services pueden comportarse de forma diferente en la forma en que controlan e interpretan los parámetros de entrada. Para obtener más información sobre la relación entre las versiones NtXxx y ZwXxx de una rutina, vea Using Nt and Zw Versions of the Native System Services Routines.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Windows Vista y versiones posteriores del sistema operativo.
Plataforma de destino	Universal
Encabezado	wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h)
Library	NtosKrnl.lib
Archivo DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Reglas de cumplimiento de DDI	HwStorPortProhibitedDIs, PowerIrpDDis