Método IDebugSymbols3::GetFieldTypeAndOffsetWide (dbgeng.h)

Artigo
02/06/2025

O método GetFieldTypeAndOffsetWide retorna o tipo de um campo e seu deslocamento dentro de um contêiner.

Sintaxe

HRESULT GetFieldTypeAndOffsetWide(
  [in]            ULONG64 Module,
  [in]            ULONG   ContainerTypeId,
  [in]            PCWSTR  Field,
  [out, optional] PULONG  FieldTypeId,
  [out, optional] PULONG  Offset
);

Parâmetros

[in] Module

Especifica o módulo que contém os tipos do contêiner e do campo.

[in] ContainerTypeId

Especifica a ID do tipo para o tipo do contêiner. Exemplos de contêineres incluem estruturas, uniões e classes.

[in] Field

Especifica o nome do campo cujo tipo e deslocamento são solicitados. Os subcampos podem ser especificados usando um caminho separado por pontos.

[out, optional] FieldTypeId

Recebe a ID do tipo do campo.

[out, optional] Offset

Recebe o deslocamento do campo Campo do local de memória base de uma instância do contêiner.

Valor de retorno

Esse método também pode retornar valores de erro. Consulte de Valores Retornados para obter mais detalhes.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
E_NOINTERFACE	Não foi possível encontrar o campo Field no tipo especificado por ContainerTypeId.

Observações

Um exemplo de um caminho separado por ponto para o parâmetro Field é o seguinte. Suponha que a estrutura MyStruct contenha um campo MyField do tipo MySubStruct e a estrutura MySubStruct contenha o campo MySubField. Em seguida, o tipo desse campo e sua localização relativa à localização da estrutura MyStruct podem ser encontrados passando "MyField.MySubField" como o parâmetro Field para esse método.

Para obter mais informações sobre tipos, consulte Types. Para obter mais informações sobre símbolos, consulte Symbols.

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	dbgeng.h (inclua Dbgeng.h)

Consulte também

GetFieldOffset

GetTypeId

IDebugSymbols3

Partilhar via