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.
HRESULT ReadMultiByteStringVirtualWide(
[in] ULONG64 Offset,
[in] ULONG MaxBytes,
[in] ULONG CodePage,
[out, optional] PWSTR Buffer,
[in] ULONG BufferSize,
[out, optional] PULONG StringBytes
);
[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 do buffer de.
[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.
Código de retorno | Descrição |
---|---|
|
O método foi bem-sucedido. |
|
O método não foi bem-sucedido. |
|
Um terminador nulo não foi encontrado depois de ler maxbytes do destino. |
Esse método também pode retornar valores de erro. Consulte de Valores Retornados para obter mais detalhes.
O mecanismo lerá até maxbytes do destino, procurando um terminador nulo. Se a cadeia de caracteres tiver mais de bufferSize caracteres, 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 for retornada, verifique se *StringBytes é maior que BufferSize.
Requisito | Valor |
---|---|
da Plataforma de Destino | Área de trabalho |
cabeçalho | dbgeng.h (inclua Dbgeng.h, Winnls.h) |