UtilLoadStringWithAlloc, funkcja

Funkcja UtilLoadStringWithAlloc przydziela i ładuje ciąg z tabeli zasobów.

Składnia

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

Parametry

uID [in]

Typ: UINT

Identyfikator ciągu do załadowania.

ppwzBuffer [out]

Typ: LPWSTR*

Lokalizacja, w której zostanie umieszczony nowo przydzielony ciąg. Ciąg musi zostać uwolniony przy użyciu coTaskMemFree , gdy nie jest już potrzebny.

cchBufferMax [in]

Typ: UINT

Maksymalna liczba znaków do załadowania z tabeli zasobów. Jeśli ciąg zasobu jest dłuższy niż określona liczba znaków, zostanie obcięty i zakończony wartością null.

Uwaga / Notatka

Ten parametr może nie być ustawiony na zero.

Wartość zwracana

Typ: HRESULT

Możliwe wartości zwracane obejmują, ale nie są ograniczone do następujących.

Kod powrotny	Opis
S_OK	Operacja zakończyła się pomyślnie.
E_INVALIDARG	Co najmniej jeden parametr nie został podany poprawnie.

Wymagania

Wymaganie	Wartość
Minimalny obsługiwany klient	Windows 8 [tylko aplikacje klasyczne]
Minimalny obsługiwany serwer	Windows Server 2012 [tylko aplikacje desktopowe]
Nagłówek	Ndattributils.h

Zobacz także

UtilStringCopyWithAlloc

UtilAssembleStringsWithAlloc

CoTaskMemFree