Funzione WindowsCreateString (winstring.h)

Articolo
10/20/2023

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

Share via