Função WindowsDuplicateString (winstring.h)

Cria uma cópia da cadeia de caracteres especificada.

Sintaxe

HRESULT WindowsDuplicateString(
  HSTRING string,
  HSTRING *newString
);

Parâmetros

string

Tipo: [in] HSTRING

A cadeia de caracteres a ser copiada.

newString

Tipo: [out] HSTRING*

Uma cópia da cadeia de caracteres.

Valor de retorno

Tipo: HRESULT

Essa função pode retornar um desses valores.

Código de retorno	Description
S_OK	O HSTRING foi copiado com êxito.
E_INVALIDARG	newString é NULL.
E_OUTOFMEMORY	Falha ao alocar o novo HSTRING.

Observações

Use a função WindowsDuplicateString para copiar um HSTRING. Se a cadeia de caracteres tiver sido criada chamando a função WindowsCreateString , a contagem de referência do buffer de backup será incrementada. Se a cadeia de caracteres foi criada chamando a função WindowsCreateStringReference , o Windows Runtime copia sua cadeia de caracteres de origem para um novo buffer e inicia uma contagem de referência, o que significa que newString não é uma cadeia de caracteres de passagem rápida.

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

Requirements

Requirement	Value
Cliente mínimo suportado	Windows 8 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo compatível	Windows Server 2012 [aplicativos da área de trabalho | Aplicativos UWP]
da Plataforma de Destino	Windows
Header	winstring.h
Library	mincore.lib

Consulte também

windowsCreateString

WindowsCreateStringReference

WindowsDeleteString