Funktionen UtilLoadStringWithAlloc

Funktionen UtilLoadStringWithAlloc allokerar och läser in en sträng från resurstabellen.

Syntax

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

Parameterar

uID [in]

Typ: UINT

Identifierare för strängen som ska läsas in.

ppwzBuffer [ut]

Typ: LPWSTR*

Platsen där den nyligen allokerade strängen placeras. Strängen måste frigöras med CoTaskMemFree när den inte längre behövs.

cchBufferMax [in]

Typ: UINT

Det maximala antalet tecken som ska läsas in från resurstabellen. Om resurssträngen är längre än det angivna antalet tecken trunkeras den och avslutas null.

Anmärkning

Den här parametern kanske inte är inställd på noll.

Returvärde

Typ: HRESULT

Möjliga returvärden inkluderar, men är inte begränsade till, följande.

Returkod	Beskrivning
S_OK	Åtgärden lyckades.
E_INVALIDARG	En eller flera parametrar har inte angetts korrekt.

Kravspecifikation

Krav	Värde
Lägsta klient som stöds	Windows 8 [endast skrivbordsappar]
Lägsta server som stöds	Windows Server 2012 [endast skrivbordsappar]
Rubrik	Ndattributils.h

Se även

UtilStringCopyWithAlloc

UtilAssembleStringsWithAlloc

CoTaskMemFree