Compartir a través de

Método IDebugRegisters2::GetDescriptionWide (dbgeng.h)

  • Artículo

El método GetDescriptionWide devuelve la descripción de un registro.

Sintaxis

HRESULT GetDescriptionWide(
  [in]            ULONG                       Register,
  [out, optional] PWSTR                       NameBuffer,
  [in]            ULONG                       NameBufferSize,
  [out, optional] PULONG                      NameSize,
  [out, optional] PDEBUG_REGISTER_DESCRIPTION Desc
);

Parámetros

[in] Register

Especifica el índice del registro para el que se solicita la descripción.

[out, optional] NameBuffer

Especifica el búfer en el que se va a almacenar el nombre del registro. Si NameBuffer es NULL, esta información no se devuelve.

[in] NameBufferSize

Especifica el tamaño, en caracteres, del búfer que especifica NameBuffer . Este tamaño incluye el espacio para el carácter de terminación '\0'.

[out, optional] NameSize

Recibe el tamaño, en caracteres, del nombre del registro en el búfer NameBuffer . Este tamaño incluye el espacio para el carácter de terminación '\0'. Si NameSize es NULL, esta información no se devuelve.

[out, optional] Desc

Recibe la descripción del registro. Consulte DEBUG_REGISTER_DESCRIPTION para obtener más detalles.

Valor devuelto

Esta lista no contiene todos los errores que pueden producirse. Para obtener una lista de posibles errores, consulte Valores HRESULT.

Código devuelto Descripción
S_OK
 Método realizado correctamente.
S_FALSE
 Método realizado correctamente. Sin embargo, el búfer no era lo suficientemente grande como para contener el nombre del registro, por lo que se truncaba.
E_UNEXPECTED
 No se ha especificado ninguna máquina de destino o no se encontró una descripción del registro.
E_INVALIDARG
 El índice del registro solicitado es mayor que el número total de registros en el equipo del destino.

Comentarios

Para obtener información general sobre la interfaz IDebugRegisters y otros métodos relacionados con el registro, consulte Registros.

Requisitos

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