Método ExtRemoteData::GetString(PWSTR,ULONG,ULONG,bool,PULONG) (engextcpp.hpp)

Artigo
02/06/2025

O método GetString lê uma cadeia de caracteres terminada em nulo da memória do destino. A cadeia de caracteres está localizada no início da região representada pelo objeto ExtRemoteData.

Sintaxe

PWSTR GetString(
  [out] PWSTR  Buffer,
  [in]  ULONG  BufferChars,
  [in]  ULONG  MaxChars,
  [in]  bool   MustFit,
        PULONG NeedChars
);

Parâmetros

[out] Buffer

Recebe a cadeia de caracteres terminada em nulo lida do destino. O tipo de buffer deve ser o mesmo que o tipo da cadeia de caracteres no destino. Se a cadeia de caracteres for uma cadeia de caracteres Unicode, o tipo de buffer deverá ser PWSTR. Se a cadeia de caracteres for uma cadeia de caracteres multibyte, o tipo de buffer deverá ser PSTR.

Observação o restante do buffer buffer, após a cadeia de caracteres, pode ser substituído por esse método.

[in] BufferChars

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

[in] MaxChars

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

[in] MustFit

Especifica o que acontece se a cadeia de caracteres for maior que BufferChars caracteres. Se MustFit for true e a cadeia de caracteres for maior que caracteres BufferChars, um ExtRemoteException será gerado. Se MustFit for false e a cadeia de caracteres for maior que caracteres do BufferChars, a cadeia de caracteres será truncada e terminada em nulo para caber dentro do buffer de buffer.

NeedChars

Valor de retorno

GetString retorna a cadeia de caracteres terminada em nulo que foi lida do destino. Este é buffer.

Observações

Esse método só poderá ser usado se a região representada pelo objeto ExtRemoteData estiver na memória virtual. Ele não funcionará se a região especificar memória física.

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	engextcpp.hpp (inclua Engextcpp.hpp)

Consulte também

ExtRemoteData

ExtRemoteData::ReadBuffer

Partilhar via