TmSinglePhaseReject-Funktion (wdm.h)
Die TmSinglePhaseReject-Routine informiert KTM darüber, dass der aufrufende Ressourcen-Manager keinen einstufigen Commitvorgang für eine angegebene Registrierung unterstützt.
Syntax
NTSTATUS TmSinglePhaseReject(
[in] PKENLISTMENT Enlistment,
[in] PLARGE_INTEGER TmVirtualClock
);
Parameter
[in] Enlistment
Ein Zeiger auf ein Eintragsobjekt. Ihre Komponente kann diesen Zeiger als Eingabe für eine ResourceManagerNotification-Rückrufroutine empfangen. Alternativ kann Ihre Komponente ObReferenceObjectByHandle aufrufen und das Objekthandle bereitstellen, das ein vorheriger Aufruf von ZwCreateEnlistment, TmCreateEnlistment oder ZwOpenEnlistment bereitgestellt hat.
[in] TmVirtualClock
Ein Zeiger auf einen virtuellen Uhrwert. Dieser Parameter ist optional und kann NULL sein.
Rückgabewert
TmSinglePhaseReject gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt diese Routine möglicherweise den folgenden Wert zurück:
| Rückgabecode | Beschreibung |
|---|---|
|
Die Transaktion oder ihre Einlistung befindet sich nicht im richtigen Zustand. |
Die Routine gibt möglicherweise andere NTSTATUS-Werte zurück.
Hinweise
Die TmSinglePhaseReject-Routine ist eine zeigerbasierte Version der ZwSinglePhaseReject-Routine .
Informationen dazu, wann die TmXxx-Routinen von KTM anstelle von ZwXxx-Routinen verwendet werden sollen, finden Sie unter Verwenden von TmXxx-Routinen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows Vista und höheren Betriebssystemversionen. |
| Zielplattform | Universell |
| Header | wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h) |
| Bibliothek | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |