PropVariantGetElem 函式 (propvarutil.h)
根據另一個 PROPVARIANT 結構中的指定專案,初始化 PROPVARIANT 結構。
語法
HRESULT PropVariantGetElem(
[in] REFPROPVARIANT propvarIn,
[in] ULONG iElem,
[out] PROPVARIANT *ppropvar
);
參數
[in] propvarIn
類型: REFPROPVARIANT
來源 PROPVARIANT 結構的參考。
[in] iElem
類型: ULONG
propvarIn中PROPVARIANT結構專案的索引。
[out] ppropvar
類型: PROPVARIANT*
當此函式傳回時,包含 具有來源 PROPVARIANT 結構所指定值的 PROPVARIANT 。
傳回值
類型: HRESULT
如果此函式成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。
備註
此協助程式函式適用于下列類型的 PROPVARIANT 結構:
- VT_LPWSTR
- VT_BSTR
- VT_BOOL
- VT_I2
- VT_I4
- VT_I8
- VT_U12
- VT_U14
- VT_U18
- VT_FILETIME
- VT_VECTOR | (VT_LPWSTR、VT_BSTR、VT_BOOL、VT_I2、VT_I4、VT_I8、VT_U12、VT_U14、VT_U18、VT_FILETIME)
- VT_ARRAY | (任一VT_BSTR、VT_BOOL、VT_I2、VT_I4、VT_I8、VT_U12、VT_U14、VT_U18)
這是內嵌函式,其原始程式碼會在 標頭中提供。 它不包含在任何 .dll 或 .lib 檔案中。
此函式會從來源 PROPVARIANT 結構擷取單一值,並使用該值來初始化輸出 PROPVARIANT 結構。 呼叫的應用程式必須使用PropVariantClear,在不再需要 PROPVARIANT時釋出ppropvar所參考的PROPVARIANT。
如果來源 PROPVARIANT 是向量或陣列, iElem 必須小於向量或陣列中的元素數目。
如果來源 PROPVARIANT 只有單一值, iElem 必須是 0。
如果來源 PROPVARIANT 是空的,此函式一律會傳回錯誤碼。
範例
下列程式碼範例會示範如何在反復專案語句中使用 PropVariantGetElem ,以存取 PROPVARIANT中的值。
// PROPVARIANT propvar;
// Assume propvar is initialized and valid.
UINT cElem = PropVariantGetElementCount(propvar);
HRESULT hr = <mark type="const">S_OK</mark>;
for (UINT iElem = 0; SUCCEEDED(hr) && iElem < cElem; iElem ++)
{
<xref rid="_stg_propvariant"/>propvarElem = {0};
hr = PropVariantGetElem(propvar, iElem, &propvarElem);
if (SUCCEEDED(hr))
{
// propvarElem is valid now.
PropVariantClear(&propvarElem);
}
}
需求
最低支援的用戶端 | Windows XP 搭配 SP2、Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 SP1 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | propvarutil.h |
可轉散發套件 | Windows 桌面搜尋 (WDS) 3.0 |
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應