Funzione TmPrePrepareComplete (wdm.h)
La routine TmPrePrepareComplete notifica a KTM che il gestore risorse chiamante ha completato la preparazione preliminare dei dati di una transazione.
Sintassi
NTSTATUS TmPrePrepareComplete(
[in] PKENLISTMENT Enlistment,
[in] PLARGE_INTEGER TmVirtualClock
);
Parametri
[in] Enlistment
Puntatore a un oggetto di integrazione. Il componente può ricevere questo puntatore come input a una routine di callback ResourceManagerNotification . In alternativa, il componente può chiamare ObReferenceObjectByHandle e fornire l'handle dell'oggetto fornito da una chiamata precedente a ZwCreateEnlistment, TmCreateEnlistment o ZwOpenEnlistment .
[in] TmVirtualClock
Puntatore a un valore di clock virtuale. Questo parametro è facoltativo e può essere NULL.
Valore restituito
TmPrePrepareComplete restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, questa routine potrebbe restituire uno dei valori seguenti:
| Codice restituito | Descrizione |
|---|---|
|
La transazione o il relativo inserimento non è nello stato corretto. Ad esempio, KTM non ha inviato una notifica di TRANSACTION_NOTIFY_PREPARE. |
La routine potrebbe restituire altri valori NTSTATUS.
Commenti
La routine TmPrePrepareComplete è una versione basata su puntatore della routine ZwPrepareComplete .
Per informazioni su quando usare le routine TmXxx di KTM anziché le routine ZwXxx , vedere Using TmXxx Routines (Uso delle routine TmXxx).
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 |