Funzione WindowsDuplicateString (winstring.h)

Crea una copia della stringa specificata.

Sintassi

HRESULT WindowsDuplicateString(
  HSTRING string,
  HSTRING *newString
);

Parametri

string

Tipo: [in] HSTRING

Stringa da copiare.

newString

Tipo: [out] HSTRING*

Copia della stringa.

Valore restituito

Tipo: HRESULT

Questa funzione può restituire uno di questi valori.

Codice restituito	Description
S_OK	HSTRING è stato copiato correttamente.
E_INVALIDARG	newString è NULL.
E_OUTOFMEMORY	Impossibile allocare il nuovo HSTRING.

Osservazioni:

Usare la funzione WindowsDuplicateString per copiare un HSTRING. Se la stringa è stata creata chiamando la funzione WindowsCreateString , il conteggio dei riferimenti del buffer di backup viene incrementato. Se la stringa è stata creata chiamando la funzione WindowsCreateStringReference , Windows Runtime copia la stringa di origine in un nuovo buffer e avvia un conteggio dei riferimenti, il che significa che newString non è una stringa pass veloce.

Ogni chiamata alla funzione WindowsDuplicateString deve essere associata a una chiamata corrispondente a WindowsDeleteString.

Requisiti

Requisito	Value
Client minimo supportato	Windows 8 [app desktop | App UWP]
Server minimo supportato	Windows Server 2012 [app desktop | App UWP]
Piattaforma di destinazione	Windows
Header	winstring.h
Library	mincore.lib

Vedere anche

WindowsCreateString

WindowsCreateStringReference

WindowsDeleteString