Funzione NtSinglePhaseReject (wdm.h)

Articolo
02/27/2024

La routine ZwSinglePhaseReject informa KTM che il gestore risorse chiamante non supporterà le operazioni di commit a fase singola per un'integrazione specificata.

Sintassi

__kernel_entry NTSYSCALLAPI NTSTATUS NtSinglePhaseReject(
  [in]           HANDLE         EnlistmentHandle,
  [in, optional] PLARGE_INTEGER TmVirtualClock
);

Parametri

[in] EnlistmentHandle

Handle per un oggetto di integrazione ottenuto da una chiamata precedente a ZwCreateEnlistment o ZwOpenEnlistment. L'handle deve avere ENLISTMENT_SUBORDINATE_RIGHTS accesso all'oggetto .

[in, optional] TmVirtualClock

Puntatore a un valore di clock virtuale. Questo parametro è facoltativo e può essere NULL.

Valore restituito

ZwSinglePhaseReject restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, questa routine potrebbe restituire uno dei valori seguenti:

Codice restituito	Descrizione
STATUS_OBJECT_TYPE_MISMATCH	L'handle specificato non è un handle per un oggetto di integrazione.
STATUS_INVALID_HANDLE	L'handle dell'oggetto non è valido.
STATUS_TRANSACTION_NOT_REQUESTED	La transazione o il relativo inserimento non è nello stato corretto.
STATUS_ACCESS_DENIED	Il chiamante non dispone dell'accesso appropriato all'oggetto di integrazione.

La routine potrebbe restituire altri valori NTSTATUS.

Commenti

Un gestore di risorse può chiamare ZwSinglePhaseReject quando riceve una notifica di TRANSACTION_NOTIFY_SINGLE_PHASE_COMMIT.

Per altre informazioni su ZwSinglePhaseReject, vedere Gestione delle operazioni di commit.

NtSinglePhaseReject e ZwSinglePhaseReject sono due versioni della stessa routine di Servizi di sistema nativi di Windows. La routine NtSinglePhaseReject nel kernel di Windows non è direttamente accessibile ai driver in modalità kernel. Tuttavia, i driver in modalità kernel possono accedere indirettamente a questa routine chiamando la routine ZwSinglePhaseReject .

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, PowerIrpDDis

Vedi anche

TmSinglePhaseReject

Uso delle versioni Nt e Zw delle routine native di Servizi di sistema

ZwCreateEnlistment

ZwOpenEnlistment

Condividi tramite