Funzione TmRecoverEnlistment (wdm.h)

Articolo
02/27/2024

La routine TmRecoverEnlistment avvia un'operazione di ripristino per la transazione associata a un'integrazione specificata.

Sintassi

NTSTATUS TmRecoverEnlistment(
  [in] PKENLISTMENT Enlistment,
  [in] PVOID        EnlistmentKey
);

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] EnlistmentKey

Puntatore al valore della chiave di integrazione specificato in precedenza come parametro EnlistmentKey da ZwCreateEnlistment o TmCreateEnlistment. Questo parametro è facoltativo e può essere NULL se resource manager non ha fornito una chiave di integrazione quando viene chiamata ZwCreateEnlistment o TmCreateEnlistment.

Valore restituito

TmRecoverEnlistment 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	Un handle di oggetto non è valido.
STATUS_TRANSACTION_REQUEST_NOT_VALID	La transazione o il relativo inserimento non è nello stato corretto.
STATUS_PENDING	KTM ha aggiunto una notifica di commit, rollback o in dubbio alla coda di notifica di Resource Manager e gestione risorse non usa una routine di callback ResourceManagerNotification .

La routine potrebbe restituire altri valori NTSTATUS.

Commenti

La routine TmRecoverEnlistment è una versione basata su puntatore della routine ZwRecoverEnlistment .

Per informazioni su quando usare le routine TmXxx di KTM anziché le routine ZwXxx , vedere Using TmXxx Routines (Uso delle routine TmXxx).

Per altre informazioni sulle operazioni di ripristino, vedere Gestione delle operazioni di ripristino.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows Vista e versioni successive di Windows.
Piattaforma di destinazione	Universale
Intestazione	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Libreria	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL