Functie UtilLoadStringWithAlloc

Met de functie UtilLoadStringWithAlloc wordt een tekenreeks uit de resourcetabel toegewezen en geladen.

Syntaxis

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

Parameterwaarden

uID [in]

Type: UINT

Id van de tekenreeks die moet worden geladen.

ppwzBuffer [out]

Type: LPWSTR*

De locatie waar de zojuist toegewezen tekenreeks wordt geplaatst. De tekenreeks moet worden vrijgemaakt met CoTaskMemFree wanneer deze niet meer nodig is.

cchBufferMax [in]

Type: UINT

Het maximum aantal tekens dat moet worden geladen uit de resourcetabel. Als de resourcetekenreeks langer is dan het aantal opgegeven tekens, wordt deze afgekapt en null-beëindigd.

Opmerking

Deze parameter is mogelijk niet ingesteld op nul.

Retourwaarde

Type: HRESULT

Mogelijke retourwaarden zijn onder meer, maar zijn niet beperkt tot, het volgende.

Retourcode	Beschrijving
S_OK	De bewerking is voltooid.
E_INVALIDARG	Een of meer parameters zijn niet correct opgegeven.

Behoeften

Voorwaarde	Waarde
Minimaal ondersteunde client	Windows 8 [alleen desktop-apps]
Minimaal ondersteunde server	Windows Server 2012 [alleen desktop-apps]
Koptekst	Ndattributils.h

Zie ook

UtilStringCopyWithAlloc

UtilAssembleStringsWithAlloc

CoTaskMemFree-