Função NtSetInformationTransaction (wdm.h)

Artigo
03/01/2024

A rotina ZwSetInformationTransaction define informações para uma transação especificada.

Sintaxe

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

Parâmetros

[in] TransactionHandle

Um identificador para um objeto de transação que foi obtido por uma chamada anterior para ZwCreateTransaction ou ZwOpenTransaction. O identificador deve ter TRANSACTION_SET_INFORMATION acesso ao objeto .

[in] TransactionInformationClass

Um valor de tipo TRANSACTION_INFORMATION_CLASS que especifica o tipo de informação a ser definido. O valor deve ser TransactionPropertiesInformation.

[in] TransactionInformation

Um ponteiro para um buffer alocado pelo chamador que contém as informações a serem definidas. O tipo de estrutura do buffer deve ser TRANSACTION_PROPERTIES_INFORMATION.

[in] TransactionInformationLength

O comprimento, em bytes, do buffer para o qual o parâmetro TransactionInformation aponta.

Retornar valor

ZwSetInformationTransaction retornará STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, essa rotina pode retornar um dos seguintes valores:

Código de retorno	Descrição
STATUS_INVALID_INFO_CLASS	O valor do parâmetro TransactionInformationClass é inválido.
STATUS_OBJECT_TYPE_MISMATCH	O identificador que o parâmetro TransactionHandle especifica não é um identificador para um objeto de transação.
STATUS_INVALID_HANDLE	Um identificador de objeto é inválido.
STATUS_ACCESS_DENIED	O chamador não tem acesso apropriado ao objeto de transação.
STATUS_INFO_LENGTH_MISMATCH	O valor do parâmetro TransactionInformationLength é inválido.
STATUS_INVALID_PARAMETER	O conteúdo do buffer especificado pelo buffer TransactionInformation é inválido.

A rotina pode retornar outros valores NTSTATUS.

Comentários

Para obter mais informações sobre ZwSetInformationTransaction, consulte Criando um cliente transacional.

NtSetInformationTransaction e ZwSetInformationTransaction são duas versões da mesma rotina do Windows Native System Services.

Para chamadas de drivers de modo kernel, as versões NtXxx e ZwXxx de uma rotina do Windows Native System Services podem se comportar de forma diferente na maneira como lidam e interpretam parâmetros de entrada. Para obter mais informações sobre a relação entre as versões NtXxx e ZwXxx de uma rotina, consulte Using Nt and Zw Versions of the Native System Services Routines.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível no Windows Vista e versões posteriores do sistema operacional.
Plataforma de Destino	Universal
Cabeçalho	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Biblioteca	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Regras de conformidade da DDI	HwStorPortProhibitedDDIs, PowerIrpDDis