Compartir a través de


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

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 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 Buffer 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, "Proceso" 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 DEBUG_HANDLE_DATA_BASIC de campo. 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, se puede considerar que el argumento Buffer 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. Después de completar correctamente el método, se puede tener acceso al contenido de este búfer al tipo especificado en la tabla anterior.

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

[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] 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
Método realizado correctamente.
 

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

Comentarios

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

Requisitos

Requisito Value
Plataforma de destino Escritorio
Encabezado dbgeng.h (include Dbgeng.h)

Consulte también

Asas

IDebugDataSpaces2

IDebugDataSpaces3

IDebugDataSpaces4