5

DetourBinarySetPayload

Brian Gianforcaro edited this page 2020-08-22 00:25:06 -07:00

Table of Contents

• DetourBinarySetPayload
• Definition
• Parameters
• Remarks
• Return value

DetourBinarySetPayload

Attach a payload to a binary.

Definition

PVOID DetourBinarySetPayload(
    _In_                   PDETOUR_BINARY pBinary,
    _In_                   REFGUID rguid,
    _In_reads_opt_(cbData) PVOID pData,
    _In_                   DWORD cbData
);

Parameters

pBinary

Pointer to the binary opened by DetourBinaryOpen

rguid

GUID of the payload to be added to binary.

pData

Pointer to payload data.

cbData

Size of the payload data in bytes.

Remarks

DetourBinarySetPayload attaches a payload to a binary opened by DetourBinaryOpen. The payload can be located at runtime using the DetourFindPayload API.

For more information on binary editing with Detours, see Payloads and DLL Import Editing in the Detours Overview.

Return value

If successful, returns TRUE; otherwise, returns FALSE.

Overview

• Home
• Frequently Asked Questions
• Using Detours
• Interception of Binary Functions
• Payloads and DLL Import Editing
• Detouring 32-bit and 64-bit Processes
• Samples

API Reference

• Detouring Target Functions
• Finding Target Functions
• Accessing Loaded Binaries and Payloads
• Modifying Binaries
• Inserting DLLs and Payloads Into New Processes