Compartir a través de

Método IDebugDataSpaces4::ReadUnicodeStringVirtual (dbgeng.h)

  • Artículo

El método ReadUnicodeStringVirtual lee una cadena Unicode terminada en null del destino y la convierte en una cadena multibyte.

Sintaxis

HRESULT ReadUnicodeStringVirtual(
  [in]            ULONG64 Offset,
  [in]            ULONG   MaxBytes,
  [in]            ULONG   CodePage,
  [out, optional] PSTR    Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  StringBytes
);

Parámetros

[in] Offset

Especifica la ubicación en el espacio de direcciones virtuales del proceso de la cadena.

[in] MaxBytes

Especifica el número máximo de bytes que se van a leer del destino.

[in] CodePage

Especifica la página de códigos que se va a usar para convertir la cadena multibyte leída del destino en una cadena Unicode. Por ejemplo, CP_ACP es la página de códigos ANSI.

[out, optional] Buffer

Recibe la cadena del destino. Si Buffer es NULL, no se devuelve esta información.

[in] BufferSize

Especifica el tamaño, en caracteres, del búfer de búfer .

[out, optional] StringBytes

Recibe el tamaño, en bytes, de la cadena en el destino. Si StringBytes es NULL, esta información no se devuelve.

Valor devuelto

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 la cadena y la cadena se truncaba para caber en el búfer. La cadena truncada termina en null si el búfer tiene espacio para al menos un carácter.
E_INVALIDARG
 No se encontró un terminador null después de leer MaxBytes del destino.
 

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

Comentarios

El motor leerá hasta MaxBytes desde el destino, buscando un terminador null. Si la cadena tiene más de caracteres BufferSize , la cadena se truncará para que se ajuste al búfer.

Requisitos

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

Consulte también

IDebugDataSpaces4

ReadMultiByteStringVirtual

ReadUnicodeStringVirtualWide