PropVariantToUInt32Vector 函式 (propvarutil.h)

發行項
03/01/2024

將數據從 PROPVARIANT 結構擷取到 ULONG 向量。

語法

PSSTDAPI PropVariantToUInt32Vector(
  [in]  REFPROPVARIANT propvar,
  [out] ULONG          *prgn,
  [in]  ULONG          crgn,
  [out] ULONG          *pcElem
);

參數

[in] propvar

類型： REFPROPVARIANT

來源 PROPVARIANT 結構的參考。

[out] prgn

類型： ULONG*

指向包含crgnULONG值的緩衝區。當此函式傳回時，緩衝區已使用從來源 PROPVARIANT 擷取的pcElemULONG元素初始化。

[in] crgn

類型： ULONG

prgn 所指向的緩衝區大小，以元素為單位。

[out] pcElem

類型： ULONG*

當此函式傳回時，包含從來源 PROPVARIANT 結構擷取的ULONG值計數。

傳回值

類型： HRESULT

此函式可以傳回下列其中一個值。

傳回碼	描述
S_OK	如果成功，則傳回 S_OK ，否則傳回錯誤值。
TYPE_E_BUFFERTOOSMALL	來源 PROPVARIANT 包含超過 crgn 值。 prgn 指向的緩衝區太小。
E_INVALIDARG	PROPVARIANT 不是適當的類型。

備註

此協助程式函式用於呼叫應用程式預期 PROPVARIANT 保留具有固定項目數目之 ULONG 值的向量的位置。

如果來源 PROPVARIANT的類型VT_VECTOR VT_UI4 | 或VT_ARRAY VT_UI4 | ，則此協助程式函式會擷取最多 crgn ULONG 值，並將其放在prgn 所指向的緩衝區中。如果 PROPVARIANT 包含的項目超過會放入 prgn 緩衝區中的元素，此函式會傳回錯誤，並將 pcElem 設定為 0。

範例

下列範例要包含在較大的程式中，示範如何使用 PropVariantToUInt32Vector 來存取 PROPVARIANT 中的 ULONG 向量值。

// PROPVARIANT propvar;
// Assume the variable propvar is initialized and valid
ULONG rgLongs[4]; // The application is expecting propvar to hold 4 ULONGs in a vector
ULONG cElems;
HRESULT hr = PropVariantToUInt32Vector(propvar, rgLongs, ARRAYSIZE(rgLongs), &cElems);
if (SUCCEEDED(hr))
{
     if (cElems == ARRAYSIZE(rgLongs))
     {
         // The application got 4 ULONGs which are now stored in rgLongs
     }
     else
     {
         // The application got cElems which are stored in the first cElems elements of rgLongs
     }
}

規格需求

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