Funzione TmRequestOutcomeEnlistment (wdm.h)
La routine TmRequestOutcomeEnlistment chiede a KTM di provare a fornire un risultato immediato (commit o rollback) per la transazione associata a un elenco specificato.
Sintassi
NTSTATUS TmRequestOutcomeEnlistment(
[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
TmRequestOutcomeEnlistment restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, questa routine potrebbe restituire il valore seguente:
| Codice restituito | Descrizione |
|---|---|
|
L'inserimento specificato è un elenco superiore. |
La routine potrebbe restituire altri valori NTSTATUS.
Commenti
La routine TmRequestOutcomeEnlistment chiede a KTM di provare a fornire un risultato immediato (risultato) per la transazione. Un gestore risorse può chiamare TmRequestOutcomeEnlistment dopo aver chiamato TmPrepareComplete o ZwPrepareComplete, se in seguito rileva che non può attendere un risultato perché, ad esempio, si è verificata una rimozione sorprendente del disco. KTM potrebbe essere in grado di forzare un rollback se tutti i responsabili delle risorse non hanno completato le operazioni di preparazione.
Per informazioni su quando usare le routine TmXxx di KTM anziché le routine ZwXxx , vedere Uso di routine TmXxx.
Per altre informazioni su TmCreateEnlistment, vedere Creazione di un Resource Manager.
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 |