UtilLoadStringWithAlloc 函式

UtilLoadStringWithAlloc函式會配置並載入資源資料表中的字串。

語法

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

uID [in]

類型： UINT

要載入之字串的識別碼。

ppwzBuffer [out]

類型： LPWSTR*

放置新配置字串的位置。不再需要字串時，必須使用 CoTaskMemFree 釋放字串。

cchBufferMax [in]

類型： UINT

要從資源資料表載入的最大字元數。如果資源字串超過指定的字元數，則會截斷並終止 Null。

注意

此參數不能設定為零。

類型： HRESULT

可能的傳回值包括但不限於下列各項。

傳回碼	描述
S_OK	作業成功。
E_INVALIDARG	尚未正確提供一或多個參數。