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

Artigo
02/26/2024

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

Sintaxe

HRESULT ReadUnicodeStringVirtualWide(
  [in]            ULONG64 Offset,
  [in]            ULONG   MaxBytes,
  [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.

[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

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

Código de retorno	Descrição
S_OK
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.

O método foi bem-sucedido.

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.