Compartilhar via

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. Submembros 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, de Campo 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 referenciados por pOutValue podem ser substituídos.

[out] pOutValue

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

Valor de retorno

Se a função for bem-sucedida, o valor retornado será zero. Caso contrário, o valor retornado é um código de erro IG_DUMP_SYMBOL_INFO.

Requisitos

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