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

Artigo
02/23/2024

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 de 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. Subcampos podem ser especificados usando um caminho separado por ponto.

[out, optional] FieldTypeId

Recebe a ID de 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.

Retornar valor

Esse método também pode retornar valores de erro. Consulte 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 Campo no tipo especificado por ContainerTypeId.

Comentários

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 em relação ao local 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 Tipos. Para obter mais informações sobre símbolos, consulte Símbolos.