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

Artigo
08/07/2023

O método ReadMultiByteStringVirtual lê uma cadeia de caracteres multibyte terminada em nulo do destino.

Sintaxe

HRESULT ReadMultiByteStringVirtual(
  [in]            ULONG64 Offset,
  [in]            ULONG   MaxBytes,
  [out, optional] PSTR    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.

[out, optional] Buffer

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

Nota O restante do buffer, seguindo a cadeia de caracteres retornada, pode ser substituído por esse método.

[in] BufferSize

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

[out, optional] StringBytes

Recebe o tamanho, em bytes, da cadeia de caracteres. 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 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 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.