Partilhar via


Método IXCLRDataProcess::GetRuntimeNameByAddress

Obtém um nome para o endereço especificado.

Nota

Esta API foi originalmente concebida para utilização interna no runtime. Embora agora seja suportada para utilização de terceiros, recomendamos que trabalhe com ICorDebug as APIs e ICorProfiler sempre que possível.

Sintaxe

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
);

Parâmetros

address
[in] Um CLRDATA_ADDRESS valor que representa um endereço de código.

flags
[in] Defina como "0".

bufLen
[in] O comprimento da memória intermédia.

namLen
[fora] Um ponteiro para o número de carateres devolvidos.

namBuf
[out, size_is(bufLen)] A memória intermédia de entrada de comprimento bufLen que armazena o nome do runtime.

displacement
[fora] Um CLRDATA_ADDRESS ponteiro para o desvio de código do símbolo devolvido.

Observações

O método fornecido faz parte da IXCLRDataProcess interface e corresponde ao 16.º bloco da tabela de método virtual.

Nota

Se a memória intermédia não for suficientemente grande para o nome, este método devolve S_FALSE e define nameLen para o comprimento da memória intermédia necessário.

Requisitos

Plataformas: Veja Requisitos de Sistema
Cabeçalho: Nenhum
Biblioteca: Nenhum
.NET Framework Versões: Disponível desde a versão 4.7

Ver também