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

Artigo
02/06/2025

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

Sintaxe

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

[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.

Valor de retorno

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
S_FALSE	O método foi bem-sucedido. No entanto, buffer não era grande o suficiente para manter a cadeia de caracteres e a cadeia de caracteres foi truncada para caber no buffer . A cadeia de caracteres truncada será terminada em nulo se buffer tiver espaço para pelo menos um caractere.
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 de Valores Retornados para obter mais detalhes.

Observações

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 .

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	dbgeng.h (inclua Dbgeng.h, Winnls.h)

Consulte também

IDebugDataSpaces4

ReadMultiByteStringVirtual

ReadUnicodeStringVirtualWide

Compartilhar via