Fonction UtilLoadStringWithAlloc

Article
06/13/2023

La fonction UtilLoadStringWithAlloc alloue et charge une chaîne à partir 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 lorsqu’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 plus longue que le nombre de caractères spécifié, elle est tronquée et terminée par null.

Notes

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

Valeur retournée

Type : HRESULT

Les valeurs de retour possibles incluent, sans s’y limiter, les éléments suivants.

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

Spécifications

Condition requise	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	Ndattributils.h

Voir aussi

UtilStringCopyWithAlloc
UtilAssembleStringsWithAlloc
CoTaskMemFree

Partager via