IDiaAddressMap::set_addressMap

Provides an address map to support image layout translations.

Syntax

HRESULT set_addressMap ( 
   DWORD                     cbData,
   struct DiaAddressMapEntry data[],
   BOOL                      imagetoSymbols
);

Parameters

cbData

[in] The number of elements in the data parameter.

data[]

[in] An array of DiaAddressMapEntry Structure structures that define the translation map.

imagetoSymbols

[in] TRUE if the data parameter defines a map from the new image layout to the original layout (as described by the debug symbols). FALSE if data is a map to the new image layout taken from the original layout.

Return Value

If successful, returns S_OK; otherwise, returns an error code.

Remarks

Usually, the DIA retrieves address translation maps from the program database (.pdb) file. If these values are missing, the IDiaAddressMap::set_imageHeaders method is called twice, once with the imagetoSymbols parameter set to TRUE and once with the imagetoSymbols parameter set to FALSE. Address map translations cannot be enabled using the IDiaAddressMap::put_addressMapEnabled method unless both translation maps are provided.

See also