Fonction UtilLoadStringWithAlloc

La fonction UtilLoadStringWithAlloc alloue et charge une chaîne hors de la table de ressources.

Syntaxe

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

Paramètres

uID [in]

Type : uiNT

Identificateur de la chaîne à charger.

ppwzBuffer [out]

Type : LPWSTR*

Emplacement où la chaîne nouvellement allouée sera placée. La chaîne doit être libérée à l’aide de CoTaskMemFree quand elle n’est plus nécessaire.

cchBufferMax [in]

Type : uiNT

Nombre maximal de caractères à charger à partir de la table de ressources. Si la chaîne de ressource est supérieure au nombre de caractères spécifié, elle est tronquée et terminée par null.

Remarque

Ce paramètre peut ne pas être défini sur zéro.

Valeur retournée

Type : HRESULT

Les valeurs de retour possibles incluent, mais ne sont pas limitées, les éléments suivants.

Code de retour	Descriptif
S_OK	L’opération a réussi.
E_INVALIDARG	Un ou plusieurs paramètres n’ont pas été fournis correctement.

Spécifications

Besoin	Valeur
Client minimal pris en charge	Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau uniquement]
En-tête de page	Ndattributils.h

Voir aussi

UtilStringCopyWithAlloc

UtilAssembleStringsWithAlloc

CoTaskMemFree