admin/Microsoft-Detours
1
0
Fork 0
mirror of https://github.com/Microsoft/Detours synced 2026-06-08 11:44:51 +00:00
Code Issues Packages Projects Releases Wiki Activity
Page: DetourUpdateThread
Pages
DetourAllocateRegionWithinJumpBounds DetourAttach DetourAttachEx DetourBinaryBywayCallback DetourBinaryClose DetourBinaryCommitCallback DetourBinaryDeletePayload DetourBinaryEditImports DetourBinaryEnumeratePayloads DetourBinaryFileCallback DetourBinaryFindPayload DetourBinaryOpen DetourBinaryPurgePayloads DetourBinaryResetImports DetourBinarySetPayload DetourBinarySymbolCallback DetourBinaryWrite DetourCodeFromPointer DetourCopyPayloadToProcess DetourCopyPayloadToProcessEx DetourCreateProcessWithDll DetourCreateProcessWithDllEx DetourCreateProcessWithDlls DetourDetach DetourEnumerateExportCallback DetourEnumerateExports DetourEnumerateImports DetourEnumerateImportsEx DetourEnumerateModules DetourFindFunction DetourFindPayload DetourFindPayloadEx DetourFindRemotePayload DetourFinishHelperProcess DetourGetContainingModule DetourGetEntryPoint DetourGetModuleSize DetourGetSizeOfPayloads DetourImportFileCallback DetourImportFuncCallback DetourImportFuncCallbackEx DetourIsHelperProcess DetourRestoreAfterWith DetourSetIgnoreTooSmall DetourSetRetainRegions DetourSetSystemRegionLowerBound DetourSetSystemRegionUpperBound DetourTransactionAbort DetourTransactionBegin DetourTransactionCommit DetourTransactionCommitEx DetourUpdateThread FAQ Home OverviewHelpers OverviewInterception OverviewPayloads Reference SampleCommem SampleCping SampleDisas SampleDtest SampleDumpe SampleDumpi SampleDynamicAlloc SampleEinst SampleExcep SampleFindFunc SampleImpmunge SampleMember SamplePayload SampleRegion SampleSetdll SampleSimple SampleSlept SampleSyelog SampleTraceapi SampleTracebld SampleTracelnk SampleTracemem SampleTracereg SampleTraceser SampleTracetcp SampleTryman SampleWithdll Samples Using Detours
Clone
8
DetourUpdateThread
Brian Gianforcaro edited this page 2020-08-28 08:51:28 +00:00
Table of Contents

DetourUpdateThread

Enlist a thread for update in the current transaction.

Definition

LONG DetourUpdateThread(
    _In_ HANDLE hThread
);

Parameters

hThread
The handle of the thread to be updated with the pending transaction. If hThread is equal to the current threads pseudo handle (as returned by GetCurrentThread()) no action is performed and NO_ERROR is returned.

Return value

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

Error codes

ERROR_NOT_ENOUGH_MEMORY
Not enough memory to record identity of thread.

Remarks

DetourUpdateThread enlists the specified thread for update when the current transaction, opened by the DetourTransactionBegin API, commits.

When a detour transaction commits, Detours insures that all threads enlisted in the transaction via the DetourUpdateThread API are updated if their instruction pointer lies within the rewritten code in either the target function or the trampoline function.

Threads not enlisted in the transaction are not updated when the transaction commits. As a result, they may attempt to execute an illegal combination of old and new code.

Calling DetourUpdateThread with a non-pseudo handle to the current thread is currently unsupported and will result in application hangs.

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.

Overview

API Reference