Skip to content

Latest commit

 

History

History
43 lines (27 loc) · 2.02 KB

natvis-add-natvis-to-pdb.md

File metadata and controls

43 lines (27 loc) · 2.02 KB
Raw
description title ms.date f1_keywords helpviewer_keywords ms.assetid
Learn more about: /NATVIS (Add Natvis to PDB)
/NATVIS (Add Natvis to PDB)
09/08/2022
/natvis
natvis
NATVIS linker option
/NATVIS linker option
-NATVIS linker option
Add Natvis file to PDB
8747fc0c-701a-4796-bb4d-818ab4465cca

/NATVIS (Add Natvis to PDB)

Specifies a debugger visualization file (a Natvis file) to embed in the PDB file generated by the linker.

Syntax

/NATVIS:filename

Parameters

filename
The pathname for a Natvis file to add to the PDB file. It embeds the debugger visualizations in the Natvis file into the PDB.

Remarks

The /NATVIS linker option embeds the debugger visualizations defined in the Natvis file filename into the PDB file generated by LINK. A Natvis file has a .natvis extension. Embedding the information allows the debugger to display the visualizations independently of the Natvis file. You can use multiple /NATVIS options to embed more than one Natvis file in the generated PDB file. For more information on how to create and use Natvis files, see Create custom views of native objects in the Visual Studio debugger.

LINK ignores /NATVIS when a PDB file isn't created by using a /DEBUG option.

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 > Command Line property page.

  3. Add the /NATVIS option to the Additional Options text box. Choose OK or Apply to save your changes.

To set this linker option programmatically

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

See also

MSVC linker reference
MSVC linker options