Funzione NtPrepareComplete (wdm.h)
La routine ZwPrepareComplete notifica a KTM che il gestore risorse chiamante ha completato la preparazione dei dati di una transazione.
Sintassi
__kernel_entry NTSYSCALLAPI NTSTATUS NtPrepareComplete(
[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
ZwPrepareComplete restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, questa routine potrebbe restituire uno dei valori seguenti:
Codice restituito | Descrizione |
---|---|
|
L'handle specificato non è un handle per un oggetto di integrazione. |
|
L'handle dell'oggetto non è valido. |
|
La transazione o il relativo inserimento non è nello stato corretto. |
|
Il chiamante non dispone dell'accesso appropriato all'oggetto di integrazione. |
La routine potrebbe restituire altri valori NTSTATUS.
Commenti
Un gestore di risorse deve chiamare ZwPrepareComplete dopo aver completato la manutenzione di una notifica di TRANSACTION_NOTIFY_PREPARE.
Dopo che un gestore di risorse ha chiamato ZwPrepareComplete, non può eseguire il rollback della transazione.
Per altre informazioni su ZwPrepareComplete, vedere Gestione delle operazioni di commit.
NtPrepareComplete e ZwPrepareComplete sono due versioni della stessa routine di Servizi di sistema nativi di Windows.
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, Ntifs.h) |
Libreria | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | PASSIVE_LEVEL |
Regole di conformità DDI | HwStorPortProhibitedDDIs, PowerIrpDDis |
Vedi anche
Uso delle versioni Nt e Zw delle routine native di Servizi di sistema