Compartilhar via


Método IXCLRDataProcess::GetRuntimeNameByAddress

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

Observação

Essa API foi originalmente desenvolvida para uso interno no runtime. Embora ela agora tenha suporte para uso de terceiros, recomendamos trabalhar com as APIs ICorDebug e ICorProfiler quando 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 tamanho do buffer.

namLen
[out] Um ponteiro para o número de caracteres retornado.

namBuf
[out, size_is(bufLen)] O buffer de entrada de comprimento bufLen que armazena o nome do runtime.

displacement
[out] Um CLRDATA_ADDRESS ponteiro para o deslocamento de código do símbolo retornado.

Comentários

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

Observação

Se o buffer não for grande o suficiente para o nome, esse método retornará S_FALSE e definirá nameLen para o comprimento do buffer necessário.

Requisitos

Plataformas: confira Requisitos do sistema
Cabeçalho: Nenhum
Biblioteca: nenhuma
Versões do .NET Framework: disponíveis desde a versão 4.7

Confira também