Share via

Função WindowsConcatString (winstring.h)

  • Artigo

Concatena duas cadeias de caracteres especificadas.

Sintaxe

HRESULT WindowsConcatString(
  HSTRING string1,
  HSTRING string2,
  HSTRING *newString
);

Parâmetros

string1

Tipo: [in] HSTRING

A primeira cadeia de caracteres a ser concatenada.

string2

Tipo: [in] HSTRING

A segunda cadeia de caracteres a ser concatenada.

newString

Tipo: [out] HSTRING*

A concatenação de string1 e string2. Se string1 e string2 forem NULL, newString será NULL. Se string1 ou string2 for NULL, newString será uma cópia da cadeia de caracteres não nula.

Retornar valor

Tipo: HRESULT

Essa função pode retornar um desses valores.

Código de retorno Descrição
S_OK
 A cadeia de caracteres concatenada foi criada com êxito.
E_INVALIDARG
 newString é NULL ou o comprimento da cadeia de caracteres1 mais o comprimento da cadeia de caracteres2 é maior que MAXUINT32, que é 4.294.967.295; ou seja, 0xFFFFFFFF hexadecimais.
E_OUTOFMEMORY
 Falha ao alocar a cadeia de caracteres concatenada.

Comentários

Cada chamada para a função WindowsConcatString deve ser correspondida com uma chamada correspondente para WindowsDeleteString.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2012 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho winstring.h

Confira também

WindowsDeleteString