DetourAttach

DetourAttach

Attach a detour to a target function.

Definition

LONG DetourAttach(
    _Inout_ PVOID * ppPointer,
    _In_    PVOID pDetour
    );

Parameters

ppPointer

Pointer to the target pointer to which the detour will be attached.

pDetour

Pointer to the detour function.

Return value

Returns NO_ERROR if successful; otherwise, returns an error code.

Error codes

ERROR_INVALID_BLOCK

The function referenced is too small to be detoured.

ERROR_INVALID_HANDLE

The ppPointer parameter is null or points to a null pointer.

ERROR_INVALID_OPERATION

No pending transaction exists.

ERROR_NOT_ENOUGH_MEMORY

Not enough memory exists to complete the operation.

Remarks

DetourAttach attaches a detour to a target function as part of the current transaction opened by the DetourTransactionBegin 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, Simple, Slept, Traceapi, Tracebld, Tracelnk, Tracemem, Tracereg, Traceser, Tracetcp, Tryman.