Compartilhar via


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

O método ReadMultiByteStringVirtualWide lê uma cadeia de caracteres multibyte terminada em nulo do destino e a converte em Unicode.

Sintaxe

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 o local da cadeia de caracteres no espaço de endereço virtual do processo.

[in] MaxBytes

Especifica o número máximo de bytes a serem lidos do destino.

[in] CodePage

Especifica a página de código a ser usada para converter a cadeia de caracteres multibyte lida do destino em uma cadeia de caracteres Unicode. Por exemplo, CP_ACP é a página de código ANSI.

[out, optional] Buffer

Recebe a cadeia de caracteres do destino. Se Buffer for NULL, essas informações não serão retornadas.

[in] BufferSize

Especifica o tamanho, em caracteres, do buffer de buffer .

[out, optional] StringBytes

Recebe o tamanho, em bytes, da cadeia de caracteres no destino. Se StringBytes for NULL, essas informações não serão retornadas.

Retornar valor

Código de retorno Descrição
S_OK
O método foi bem-sucedido.
S_FALSE
O método não foi bem-sucedido.
E_INVALIDARG
Um terminador nulo não foi encontrado depois de ler MaxBytes do destino.
 

Esse método também pode retornar valores de erro. Consulte Valores retornados para obter mais detalhes.

Comentários

O mecanismo lerá até MaxBytes do destino, procurando um terminador nulo. Se a cadeia de caracteres tiver mais de caracteres BufferSize , a cadeia de caracteres será truncada para caber no Buffer.

Observe que, mesmo que S_OK seja retornado, o buffer pode não ter sido grande o suficiente para armazenar a cadeia de caracteres. Nesse caso, a cadeia de caracteres é truncada para caber no Buffer. A cadeia de caracteres truncada será terminada em nulo se Buffer tiver espaço para pelo menos um caractere. Depois que a chamada retornar, marcar para ver se *StringBytes é maior que BufferSize.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho dbgeng.h (inclua Dbgeng.h, Winnls.h)

Confira também

IDebugDataSpaces4

ReadMultiByteStringVirtual

ReadUnicodeStringVirtualWide