DetourTransactionBegin
Begin a new transaction for attaching or detaching detours.
Definition
LONG DetourTransactionBegin(VOID);
Return value
Returns NO_ERROR if successful; otherwise returns ERROR_INVALID_OPERATION.
Error codes
- ERROR_INVALID_OPERATION
- A pending transaction already exists.
Remarks
DetourTransactionBegin begins a new transaction for attaching or
detaching detours.
After beginning a transaction, a program calls the
DetourAttach or
DetourAttachEx API to attach a detour to a
target function, calls the DetourDetach API to
detach a detour from a target function, or calls the
DetourUpdateThread API to include include
a thread in the transaction update.
The attach, detach, and thread operations do not take effect until the
program commits the transaction using the
DetourTransactionCommit or
DetourTransactionCommitEx API.
Alternatively, the program can abort the transaction using the
DetourTransactionAbort API.
For more information on using Detours to intercept function calls, see Interception of Binary Functions or Using Detours in the Detours Overview.
Related Samples
Commem, Cping, Dtest, Excep, FindFunc, Member, Simple, Slept, Traceapi, Tracebld, Tracelnk, Tracemem, Tracereg, Traceser, Tracetcp, Tryman.