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 di stringa.

Valore restituito

Tipo: HRESULT

Questa funzione può restituire uno di questi valori.

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

Commenti

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, il Windows Runtime copia la stringa di origine in un nuovo buffer e avvia un conteggio dei riferimenti, ovvero newString non è una stringa pass veloce.

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

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 [app desktop | App UWP]
Server minimo supportato	Windows Server 2012 [app desktop | App UWP]
Piattaforma di destinazione	Windows
Intestazione	winstring.h

Vedi anche

WindowsCreateString

WindowsCreateStringReference

WindowsDeleteString