Condividi tramite


Funzione WindowsCreateString (winstring.h)

Crea un nuovo HSTRING basato sulla stringa di origine specificata.

Sintassi

HRESULT WindowsCreateString(
  PCNZWCH sourceString,
  UINT32  length,
  HSTRING *string
);

Parametri

sourceString

Tipo: [in, facoltativo] LPCWSTR

Stringa con terminazione Null da usare come origine per il nuovo HSTRING. Per creare una nuova stringa vuota o NULL , passare NULL per sourceString e 0 per la lunghezza.

length

Tipo: [in] UINT32

Lunghezza di sourceString, in caratteri Unicode. Deve essere 0 se sourceString è NULL.

string

Tipo: [out] HSTRING*

Puntatore all'oggetto HSTRING appena creato o NULL se si verifica un errore. Qualsiasi contenuto esistente nella stringa viene sovrascritto. HSTRING è un tipo di handle standard.

Valore restituito

Tipo: HRESULT

Questa funzione può restituire uno di questi valori.

Codice restituito Descrizione
S_OK
HSTRING è stato creato correttamente.
E_INVALIDARG
la stringa è NULL.
E_OUTOFMEMORY
Impossibile allocare il nuovo HSTRING.
E_POINTER
sourceString è NULL e la lunghezza è diversa da zero.

Commenti

Usare la funzione WindowsCreateString per allocare un nuovo HSTRING. Il Windows Runtime copia la stringa nel buffer di backup del nuovo HSTRING e gestisce la durata del buffer usando un conteggio dei riferimenti. Chiamare la funzione WindowsCreateStringReference per creare una stringa di passaggio rapido, che usa una stringa esistente senza copiarla.

Chiamare la funzione WindowsDeleteString per annullare l'allocazione di HSTRING. Ogni chiamata alla funzione WindowsCreateString deve corrispondere a una chiamata a WindowsDeleteString.

Per creare una nuova stringa vuota o NULL , passare NULL per sourceString e 0 per la lunghezza.

Se sourceString include caratteri Null incorporati, la funzione WindowsCreateString copia tutti i caratteri nel carattere null di terminazione.

Requisiti

   
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

WindowsCreateStringReference

WindowsDeleteString