共用方式為


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
未正確提供一或多個參數。

需求

要求 價值觀
最低支援的用戶端
Windows 8 [僅限傳統型應用程式]
最低支援的伺服器
Windows Server 2012 [僅限傳統型應用程式]
頁首
Ndattributils.h

另請參閱

UtilStringCopyWithAlloc

UtilAssembleStringsWithAlloc

CoTaskMemFree