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

El método ReadUnicodeStringVirtualWide lee una cadena Unicode terminada en null del destino.

Sintaxis

HRESULT ReadUnicodeStringVirtualWide(
  [in]            ULONG64 Offset,
  [in]            ULONG   MaxBytes,
  [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.

[out, optional] Buffer

Recibe la cadena del destino. Si de búfer es NULL, no se devuelve esta información.

Nota El resto del búfer, después de la cadena devuelta, podría sobrescribirse mediante este método.

 

[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. Si StringBytes es NULL, esta información no se devuelve.

Valor devuelto

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

Código devuelto	Descripción
S_OK
S_FALSE	El método se realizó correctamente. Sin embargo, Búfer no era lo suficientemente grande como para contener la cadena y la cadena se truncaba para caber en Buffer. La cadena truncada termina en null si buffer tiene espacio para al menos un carácter.
E_INVALIDARG	No se encontró un terminador null después de leer MaxBytes desde el destino.

 

El método se realizó correctamente.

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.

Requisitos

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

Consulte también

IDebugDataSpaces4

readMultiByteStringVirtualWide

ReadUnicodeStringVirtual