共用方式為

initPropVariantVectorFromPropVariant 函式 (propvarutil.h)

  • 發行項

使用儲存在另一個 PROPVARIANT中的值，初始化 PROPVARIANT結構中的向量專案。

語法

PSSTDAPI InitPropVariantVectorFromPropVariant(
  [in]  REFPROPVARIANT propvarSingle,
  [out] PROPVARIANT    *ppropvarVector
);

參數

[in] propvarSingle

類型： REFPROPVARIANT

包含單一值的來源 PROPVARIANT 結構參考。

[out] ppropvarVector

類型： PROPVARIANT*

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

傳回值

類型： HRESULT

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

備註

此函式可用來將包含單一值的 PROPVARIANT 結構轉換成向量值。

針對簡單的來源類型，此函式會將 PROPVARIANT 初始化為一個元素的向量。

對於包含字串的來源，此函式會使用從來源字串擷取的零個或多個子字串初始化 PROPVARIANT ，並將分號視為分隔符。 如需詳細資訊，請參閱 InitPropVariantFromStringAsVector 。

支援下列輸入類型：

  • VT_I2
  • VT_UI2
  • VT_I4
  • VT_UI4
  • VT_I8
  • VT_UI8
  • VT_R8
  • VT_BOOL
  • VT_DATE
  • VT_FILETIME
  • VT_BSTR
  • VT_LPWSTR
未來可能支援其他類型。

範例

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

// PROPVARIANT propvarSource;
// Assume propvarSource is initialized and valid.

if (PropVariantGetElementCount(propvarSource) == 1)
{
    PROPVARIANT propvar;

    HRESULT hr = InitPropVariantVectorFromPropVariant(propvarSource, &propvar);

    if (SUCCEEDED(hr))
    {
       // propvar now is valid and is either VT_EMPTY or contains a vector.
       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

另請參閱

InitPropVariantFromStringAsVector

PropVariantGetElem

PropVariantGetElementCount