initPropVariantFromResource 函式 (propvarutil.h)

發行項
08/25/2023

根據內嵌在可執行檔中的字串資源，初始化 PROPVARIANT 結構。

語法

PSSTDAPI InitPropVariantFromResource(
  [in]  HINSTANCE   hinst,
  [in]  UINT        id,
  [out] PROPVARIANT *ppropvar
);

參數

[in] hinst

類型： HINSTANCE

處理其可執行檔包含字串資源的模組實例。

[in] id

類型： UINT

要載入之字串的整數識別碼。

[out] ppropvar

類型： PROPVARIANT*

當此函式傳回時，會包含初始化的 PROPVARIANT 結構。

傳回值

類型： HRESULT

如果此函式成功，則會傳回 S_OK。否則，它會傳回 HRESULT 錯誤碼。

備註

此函式會建立VT_LPWSTR propvariant。如果指定的資源不存在，它會使用空字串初始化 PROPVARIANT 。超過 1024 個字元的資源字串會被截斷，並以 Null 結束。

範例

下列範例要包含在較大的程式中，示範如何使用 InitPropVariantFromResource。

// HINSTANCE hinst;
// UINT id;
// Assume variables hinst and id are initialized and valid.
PROPVARIANT propvar;

HRESULT hr = InitPropVariantFromResource(hinst, id, &propvar);

if (SUCCEEDED(hr))
{
    // propvar now is valid and has type VT_LPWSTR.
    PropVariantClear(&propvar);
}

需求


最低支援的用戶端	Windows XP 搭配 SP2、Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 SP1 [僅限傳統型應用程式]
目標平台	Windows
標頭	propvarutil.h
程式庫	Propsys.lib
Dll	Propsys.dll (6.0 版或更新版本)
可轉散發套件	Windows 桌面搜尋 (WDS) 3.0