Método IDebugDataSpaces3::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