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

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

Sintaxis

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

Parámetros

[in] Offset

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

[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 que se lee 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 de búfer 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	El método se realizó correctamente.
S_FALSE	El método no se realizó correctamente.
E_INVALIDARG	No se encontró un terminador null después de leer MaxBytes desde el destino.

 

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

Observaciones

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

Tenga en cuenta que incluso si se devuelve S_OK, es posible que el búfer no haya sido lo suficientemente grande como para almacenar la cadena. En este caso, la cadena se trunca para caber en Búfer. La cadena truncada termina en null si buffer tiene espacio para al menos un carácter. Después de que se devuelva la llamada, compruebe si *StringBytes es mayor que BufferSize.

Requisitos

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

Consulte también

IDebugDataSpaces4

ReadMultiByteStringVirtual

readUnicodeStringVirtualWide