Función WindowsDuplicateString (winstring.h)

Crea una copia de la cadena especificada.

Syntax

HRESULT WindowsDuplicateString(
  HSTRING string,
  HSTRING *newString
);

Parámetros

string

Tipo: [in] HSTRING

Cadena que se va a copiar.

newString

Tipo: [out] HSTRING*

Una copia de cadena.

Valor devuelto

Tipo: HRESULT

Esta función puede devolver uno de estos valores.

Código de retorno	Description
S_OK	HSTRING se copió correctamente.
E_INVALIDARG	newString es NULL.
E_OUTOFMEMORY	No se pudo asignar el nuevo HSTRING.

Observaciones

Use la función WindowsDuplicateString para copiar un HSTRING. Si la cadena se creó mediante una llamada a la función WindowsCreateString , se incrementa el recuento de referencias del búfer de respaldo. Si la cadena se creó llamando a la función WindowsCreateStringReference , Windows Runtime copia su cadena de origen en un nuevo búfer e inicia un recuento de referencias, lo que significa que newString no es una cadena de paso rápido.

Cada llamada a la función WindowsDuplicateString debe coincidir con una llamada correspondiente a WindowsDeleteString.

Requisitos

Requirement	Importancia
Cliente mínimo compatible	Windows 8 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo admitido	Windows Server 2012 [aplicaciones de escritorio | Aplicaciones para UWP]
de la plataforma de destino de	Windows
Header	winstring.h
Library	RuntimeObject.lib

Consulte también

windowsCreateString

WindowsCreateStringReference

WindowsDeleteString