共用方式為

InitPropVariantFromPropVariantVectorElem 函式 (propvarutil.h)

  • 發行項

根據指定的 PROPVARIANT 向量專案，初始化 PROPVARIANT 結構。

語法

PSSTDAPI InitPropVariantFromPropVariantVectorElem(
  [in]  REFPROPVARIANT propvarIn,
  [in]  ULONG          iElem,
  [out] PROPVARIANT    *ppropvar
);

參數

[in] propvarIn

類型： REFPROPVARIANT

來源 PROPVARIANT 結構。

[in] iElem

類型： ULONG

來源 PROPVARIANT 結構專案的索引。

[out] ppropvar

類型： 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)
未來可能支援其他類型。

此函式會從來源 PROPVARIANT 結構擷取單一值，並使用該值來初始化輸出 PROPVARIANT 結構。 呼叫的應用程式必須使用 PropVariantClear，在不再需要 PROPVARIANT 時釋出 ppropvar 所參考的 PROPVARIANT。

如果來源 PROPVARIANT 是向量或數位， iElem 必須小於向量或數位中的元素數目。

如果來源 PROPVARIANT 有單一值， iElem 必須是 0。

如果來源 PROPVARIANT 是空的，此函式一律會傳回錯誤碼。

您可以使用 PropVariantGetElementCount 來取得向量或陣列中的元素數目。

範例

下列程式代碼範例會示範如何在反覆運算語句中使用 InitPropVariantFromPropVariantVectorElem 來存取 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 ++)
{
    PROPVARIANT propvarElem = {0};

    hr = InitPropVariantFromPropVariantVectorElem(propvar, iElem, &propvarElem);

    if (SUCCEEDED(hr))
    {
        // propvarElem is now valid.

        PropVariantClear(&propvarElem);
    }
}

規格需求

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

另請參閱

PropVariantGetElem