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 submembrados 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 la excepción se controla o se omite, el valor devuelto es cero. En este caso, los datos más allá del final del búfer al que hace referencia pOutValue podrían sobrescribirse.

[out] pOutValue

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

Valor devuelto

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

Requisitos

Requisito Value
Plataforma de destino Escritorio
Encabezado wdbgexts.h (include Wdbgexts.h, Dbgeng.h)