共用方式為

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 是空的，此函式一律會傳回錯誤碼。

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

範例

下列程式碼範例會示範如何在反復專案語句中使用 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

另請參閱

InitPropVariantFromPropVariantVectorElem