Funzione UtilLoadStringWithAlloc

La funzione UtilLoadStringWithAlloc alloca e carica una stringa 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à inserita 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 specificato, viene troncata e terminata con null.

Annotazioni

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 riuscita.
E_INVALIDARG	Uno o più parametri non sono stati forniti correttamente.

Requisiti

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

Vedere anche

UtilStringCopyWithAlloc

UtilAssembleStringsWithAlloc

CoTaskMemFree