Método IDebugDataSpaces3::ReadTagged (dbgeng.h)

Artículo
02/26/2024

El método ReadTagged lee los datos etiquetados que podrían estar asociados a una sesión del depurador.

Sintaxis

HRESULT ReadTagged(
  [in]            LPGUID Tag,
  [in]            ULONG  Offset,
  [out, optional] PVOID  Buffer,
  [in]            ULONG  BufferSize,
  [out, optional] PULONG TotalSize
);

Parámetros

[in] Tag

Especifica el GUID que identifica los datos solicitados.

[in] Offset

Especifica el desplazamiento dentro de los datos que se van a leer.

[out, optional] Buffer

Recibe los datos. Si Buffer es NULL, no se devuelven los datos.

[in] BufferSize

Especifica el tamaño en bytes del búfer de búfer. Este es el número máximo de bytes que se devolverán.

[out, optional] TotalSize

Recibe el tamaño total en bytes de los datos especificados por Tag.

Valor devuelto

Código devuelto	Descripción
S_OK	Método realizado correctamente.
E_NOINTERFACE	No se encontraron datos identificados por Tag .

Este método también puede devolver valores de error. Consulte Valores devueltos para obtener más detalles.

Comentarios

Algunas sesiones del depurador tienen datos adicionales arbitrarios disponibles. Por ejemplo, cuando se crea un archivo de volcado, también se pueden crear archivos de información de volcado adicionales que contengan información adicional. Estos datos adicionales se etiquetan con un identificador único global y solo se pueden recuperar a través de la etiqueta .

LPGUID es un puntero a un identificador único de 128 bits. Se define en el archivo de encabezado Microsoft Windows SDK guiddef.h.