Função GetFieldData (wdbgexts.h)

  • Artigo

A função GetFieldData retorna o valor de um membro em uma estrutura.

Sintaxe

ULONG GetFieldData(
  [in]  ULONG64 TypeAddress,
  [in]  LPCSTR  Type,
  [in]  LPCSTR  Field,
  [in]  ULONG   OutSize,
  [out] PVOID   pOutValue
);

Parâmetros

[in] TypeAddress

Especifica o endereço da estrutura na memória do destino.

[in] Type

Especifica o nome do tipo da estrutura. Isso pode ser qualificado com um nome de módulo, por exemplo, mymodule!mystruct.

[in] Field

Especifica o nome do membro na estrutura cujo valor será retornado. Submembers podem ser especificados usando um caminho separado por período, por exemplo, "myfield.mysubfield".

Se o tamanho da estrutura apontada por TypeAddress for menor que 8 bytes, Field poderá ser NULL; nesse caso, toda a estrutura é copiada para pOutValue.

[in] OutSize

Especifica o tamanho, em bytes, do buffer pOutValue.

Se OutSize for menor que o tamanho do valor retornado, uma mensagem de erro será impressa e uma exceção será gerada; se a exceção for tratada ou ignorada, o valor retornado será zero. Nesse caso, os dados além do final do buffer referenciado por pOutValue podem ser substituídos.

[out] pOutValue

Recebe o valor do membro. Ou, o valor do tipo, se Field for NULL.

Retornar valor

Se a função obtiver êxito, o valor retornado será zero. Caso contrário, o valor retornado será um código de erro IG_DUMP_SYMBOL_INFO.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho wdbgexts.h (inclua Wdbgexts.h, Dbgeng.h)