Compartir a través de

Función GetFieldData (wdbgexts.h)

  • Artículo

La función GetFieldData devuelve el valor de un miembro de una estructura.

Sintaxis

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

Parámetros

[in] TypeAddress

Especifica la dirección de la estructura en la memoria del destino.

[in] Type

Especifica el nombre del tipo de la estructura. Esto se puede calificar con un nombre de módulo, por ejemplo, mymodule!mystruct.

[in] Field

Especifica el nombre del miembro de la estructura cuyo valor se devolverá. Los submembers se pueden especificar mediante una ruta de acceso separada por puntos, por ejemplo, "myfield.mysubfield".

Si el tamaño de la estructura a la que apunta typeAddress es inferior a 8 bytes, Field puede ser null; en este caso, toda la estructura se copia en pOutValue.

[in] OutSize

Especifica el tamaño, en bytes, del búfer pOutValue.

Si outSize es menor que el tamaño del valor devuelto, se imprime un mensaje de error y se genera una excepción; si se controla o se omite la excepción, el valor devuelto es cero. En este caso, es posible sobrescribir los datos más allá del final del búfer al que hace referencia pOutValue.

[out] pOutValue

Recibe el valor del miembro. O bien, el valor del tipo, si Campo es NULL.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es cero. De lo contrario, el valor devuelto es un código de error IG_DUMP_SYMBOL_INFO.

Requisitos

Requisito Valor
de la plataforma de destino de Escritorio
encabezado de wdbgexts.h (incluya Wdbgexts.h, Dbgeng.h)