Edit

Share via

IXCLRDataProcess::GetRuntimeNameByAddress Method

  • Article

Gets a name for the given address.

Note

This API was originally designed for internal use in the runtime. Although it is now supported for 3rd party use, we recommend working with ICorDebug and ICorProfiler APIs when possible.

Syntax

HRESULT GetRuntimeNameByAddress(
    [in] CLRDATA_ADDRESS address,
    [in] ULONG32 flags,
    [in] ULONG32 bufLen,
    [out] ULONG32 *nameLen,
    [out, size_is(bufLen)] WCHAR nameBuf[],
    [out] CLRDATA_ADDRESS* displacement
);

Parameters

address
[in] A CLRDATA_ADDRESS value that represents a code address.

flags
[in] Set to '0'.

bufLen
[in] The length of the buffer.

namLen
[out] A pointer to the number of characters returned.

namBuf
[out, size_is(bufLen)] The input buffer of length bufLen that stores the runtime name.

displacement
[out] A CLRDATA_ADDRESS pointer to the code offset of the returned symbol.

Remarks

The provided method is part of the IXCLRDataProcess interface and corresponds to the 16th slot of the virtual-method table.

Note

If the buffer is not large enough for the name, this method returns S_FALSE and sets nameLen to the required buffer length.

Requirements

Platforms: See System Requirements
Header: None
Library: None
.NET Framework Versions: Available since 4.7

See also