Funzione UtilLoadStringWithAlloc

Articolo
06/13/2023

La funzione UtilLoadStringWithAlloc alloca e carica una stringa fuori dalla tabella delle risorse.

Sintassi

HRESULT UtilLoadStringWithAlloc(
  _In_  UINT   uID,
  _Out_ LPWSTR *ppwzBuffer,
  _In_  UINT   cchBufferMax
);

Parametri

uID [in]

Tipo: UINT

Identificatore della stringa da caricare.

ppwzBuffer [out]

Tipo: LPWSTR*

Posizione in cui verrà posizionata la stringa appena allocata. La stringa deve essere liberata usando CoTaskMemFree quando non è più necessaria.

cchBufferMax [in]

Tipo: UINT

Numero massimo di caratteri da caricare dalla tabella delle risorse. Se la stringa di risorsa è più lunga del numero di caratteri specificati, viene troncata e terminata con null.

Nota

Questo parametro potrebbe non essere impostato su zero.

Valore restituito

Tipo: HRESULT

I valori restituiti possibili includono, ma non sono limitati a, quanto segue.

Codice restituito	Descrizione
S_OK	Operazione completata.
E_INVALIDARG	Uno o più parametri non sono stati forniti correttamente.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 [solo app desktop]
Server minimo supportato	Windows Server 2012 [solo app desktop]
Intestazione	Ndattributils.h

Vedi anche

UtilStringCopyWithAlloc
UtilAssembleStringsWithAlloc
CoTaskMemFree

Condividi tramite