Skip to content

Latest commit

 

History

History
43 lines (27 loc) · 1.71 KB

functionpadmin-create-hotpatchable-image.md

File metadata and controls

43 lines (27 loc) · 1.71 KB
description title ms.date f1_keywords helpviewer_keywords ms.assetid
Learn more about: /FUNCTIONPADMIN (Create hotpatchable image)
/FUNCTIONPADMIN (Create hotpatchable image)
09/09/2022
VC.Project.VCLinkerTool.CreateHotPatchableImage
/functionpadmin
-FUNCTIONPADMIN linker option
/FUNCTIONPADMIN linker option
25b02c13-1add-4fbd-add9-fcb30eb2cae7

/FUNCTIONPADMIN (Create hotpatchable image)

Tells the linker to prepare an executable image for hot patching.

Syntax

/FUNCTIONPADMIN[:size]

Arguments

size
The amount of padding to add to the beginning of each function in bytes. On x86 the default is 5 bytes of padding and on x64 the default is 6 bytes. On other targets a value must be provided.

Remarks

In order for the linker to produce a hotpatchable image, the .obj files must be compiled by using the /hotpatch (Create hotpatchable image) compiler option.

When you compile and link an image with a single invocation of cl.exe, /hotpatch implies /FUNCTIONPADMIN.

To set this linker option in the Visual Studio development environment

  1. Open the project's Property Pages dialog box. For more information, see Set compiler and build properties.

  2. Select the Configuration Properties > Linker > General property page.

  3. Modify the Create Hot Patchable Image property. Choose OK or Apply to save your changes.

To set this linker option programmatically

  • See xref:Microsoft.VisualStudio.VCProjectEngine.VCLinkerTool.AdditionalOptions%2A.

See also

MSVC linker reference
MSVC linker options