UtilLoadStringWithAlloc işlevi

UtilLoadStringWithAlloc işlevi kaynak tablosundan bir dize ayırır ve yükler.

Sözdizimi

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

Parametreler

uID [in]

Tür: UINT

Yüklenecek dizenin tanımlayıcısı.

ppwzBuffer [out]

Tür: LPWSTR*

Yeni ayrılan dizenin yerleştirileceği konum. Artık gerekli olmadığında , dizeNin CoTaskMemFree kullanılarak serbest kalması gerekir.

cchBufferMax [in]

Tür: UINT

Kaynak tablosundan yüklenecek karakter sayısı üst sınırı. Kaynak dizesi belirtilen karakter sayısından uzunsa kesilir ve null olarak sonlandırılır.

Uyarı

Bu parametre sıfır olarak ayarlanmayabilir.

Dönüş değeri

Tür: HRESULT

Olası dönüş değerleri aşağıdakileri içerir ancak bunlarla sınırlı değildir.

İade kodu	Açıklama
S_OK	İşlem başarılı oldu.
E_INVALIDARG	Bir veya daha fazla parametre doğru sağlanmadı.

Gereksinimler

Gereksinim	Değer
Desteklenen en düşük düzeydeki istemci	Windows 8 [yalnızca masaüstü uygulamaları]
Desteklenen en düşük sunucu	Windows Server 2012 [yalnızca masaüstü uygulamaları]
Başlık	Ndattributils.h

Ayrıca bakınız

UtilStringCopyWithAlloc

UtilAssembleStringsWithAlloc

CoTaskMemFree