Método IDebugDataSpaces4::ReadTagged (dbgeng.h)
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 de búfer es NULL, no se devuelven los datos.
[in] BufferSize
Especifica el tamaño en bytes del búfer 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 Etiqueta.
Valor devuelto
| Código devuelto | Descripción |
|---|---|
|
El método se realizó correctamente. |
|
No se encontraron datos identificados por etiqueta. |
Este método también puede devolver valores de error. Consulte valores devueltos para obtener más información.
Observaciones
Algunas sesiones del depurador tienen datos adicionales arbitrarios disponibles. Por ejemplo, cuando se crea un archivo de volcado de memoria, 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 guiddef.h del archivo de encabezado del SDK de Microsoft Windows.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Escritorio |
| encabezado de | dbgeng.h (include Dbgeng.h) |