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

Artículo
02/06/2025

El método ReadHandleData recupera información sobre un objeto del sistema especificado por un identificador del sistema.

Sintaxis

HRESULT ReadHandleData(
  [in]            ULONG64 Handle,
  [in]            ULONG   DataType,
  [out, optional] PVOID   Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  DataSize
);

Parámetros

[in] Handle

Especifica el identificador del sistema del objeto cuyos datos se solicitan. Consulte Handles (Identificadores) para obtener información sobre los identificadores del sistema.

[in] DataType

Especifica el tipo de datos que se va a devolver para el identificador del sistema. La tabla siguiente contiene los valores válidos, junto con el tipo de valor devuelto correspondiente:

Valor	Descripción
DEBUG_HANDLE_DATA_TYPE_BASIC	Devuelve información básica sobre el objeto del sistema. En este caso, el argumento Búfer se puede considerar que tiene el tipo PDEBUG_HANDLE_DATA_BASIC.
DEBUG_HANDLE_DATA_TYPE_TYPE_NAME	Devuelve el nombre del tipo de objeto. Por ejemplo, "Procesar" o "Subproceso". En este caso, el argumento buffer se puede considerar que tiene el tipo PSTR.
DEBUG_HANDLE_DATA_TYPE_OBJECT_NAME	Devuelve el nombre del objeto . Esto incluye su ubicación en el directorio de objetos. En este caso, el argumento buffer se puede considerar que tiene el tipo PSTR.
DEBUG_HANDLE_DATA_TYPE_HANDLE_COUNT	Devuelve el número de identificadores mantenidos por el objeto . Esto es similar al campo DEBUG_HANDLE_DATA_BASIC.HandleCount. En este caso, el argumento buffer se puede considerar que tiene el tipo PULONG.
DEBUG_HANDLE_DATA_TYPE_TYPE_NAME_WIDE	Devuelve el nombre del tipo de objeto. En este caso, el argumento buffer se puede considerar que tiene el tipo PWSTR.
DEBUG_HANDLE_DATA_TYPE_OBJECT_NAME_WIDE	Devuelve el nombre del objeto . En este caso, el argumento buffer se puede considerar que tiene el tipo PWSTR.

[out, optional] Buffer

Recibe los datos del objeto. Tras completar correctamente el método, se puede acceder al contenido de este búfer mediante la conversión de Búfer al tipo especificado en la tabla anterior.

Si de búfer es NULL, no se devuelve esta información.

[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] DataSize

Recibe el tamaño de los datos en bytes. Si DataSize es NULL, esta información no se devuelve.

Valor devuelto

Código devuelto	Descripción
S_OK	El método se realizó correctamente.

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

Observaciones

Este método solo está disponible en la depuración en modo de usuario.

Requisitos

Requisito	Valor
de la plataforma de destino de	Escritorio
encabezado de	dbgeng.h (include Dbgeng.h)

Consulte también

Manijas

IDebugDataSpaces2

IDebugDataSpaces3

IDebugDataSpaces4

Compartir a través de