Funzione TmPrepareEnlistment (wdm.h)
La routine TmPrepareEnlistment avvia l'operazione di preparazione per una transazione specificata.
Sintassi
NTSTATUS TmPrepareEnlistment(
[in] PKENLISTMENT Enlistment,
[in] PLARGE_INTEGER TmVirtualClock
);
Parametri
[in] Enlistment
Puntatore a un oggetto di inserimento. 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 che una chiamata precedente a ZwCreateEnlistment, TmCreateEnlistment o ZwOpenEnlistment fornito.
[in] TmVirtualClock
Puntatore a un valore di orologio virtuale. Questo parametro è facoltativo e può essere NULL.
Valore restituito
TmPrepareEnlistment restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, questa routine potrebbe restituire uno dei valori seguenti:
| Codice restituito | Descrizione |
|---|---|
|
Il chiamante non è un gestore delle transazioni superiore per l'inserimento. |
|
Il chiamante non è stato registrato per ricevere notifiche di TRANSACTION_NOTIFY_PREPARE_COMPLETE. |
|
La transazione dell'elenco non è in uno stato che consente di entrare nella fase di preparazione. |
|
Il chiamante non dispone dell'accesso appropriato all'oggetto enlistment. |
La routine potrebbe restituire altri valori NTSTATUS.
Commenti
La routine TmPrepareEnlistment è una versione basata su puntatore della routine ZwPrepareEnlistment.
Solo i responsabili delle transazioni superiori possono chiamare TmPrepareEnlistment.
Per informazioni su quando usare le routine TmXxx di KTM anziché le routine Zw Xxx, vedere Uso di 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 |