Método IDebugDataSpaces4::ReadUnicodeStringVirtual (dbgeng.h)
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 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 |
|---|---|
|
El método se realizó correctamente. |
|
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. |
|
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.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Escritorio |
| encabezado de | dbgeng.h (include Dbgeng.h, Winnls.h) |