Compartir a través de

Función WindowsDuplicateString (winstring.h)

  • Artículo

Crea una copia de la cadena especificada.

Sintaxis

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 la cadena.

Valor devuelto

Tipo: HRESULT

Esta función puede devolver uno de estos valores.

Código devuelto Descripción
S_OK
 HSTRING se copió correctamente.
E_INVALIDARG
 newString es NULL.
E_OUTOFMEMORY
 No se pudo asignar el nuevo HSTRING.

Comentarios

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, el 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

Requisito Value
Cliente mínimo compatible Windows 8 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2012 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado winstring.h

Consulte también

WindowsCreateString

WindowsCreateStringReference

WindowsDeleteString