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.
Retornar valor
Tipo: HRESULT
Essa função pode retornar um desses valores.
| Código de retorno | Descrição |
|---|---|
|
O HSTRING foi copiado com êxito. |
|
newString é NULL. |
|
Falha ao alocar o novo HSTRING. |
Comentários
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 tiver sido criada chamando a função WindowsCreateStringReference, o Windows Runtime copiará sua cadeia de caracteres de origem para um novo buffer e iniciará 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 a 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 |