PropVariantToUInt16VectorAlloc 函式 (propvarutil.h)

發行項
03/01/2024

將數據從 PROPVARIANT 結構擷取到新配置的 不帶正負號短 向量。

語法

PSSTDAPI PropVariantToUInt16VectorAlloc(
  [in]  REFPROPVARIANT propvar,
  [out] USHORT         **pprgn,
  [out] ULONG          *pcElem
);

參數

[in] propvar

類型： REFPROPVARIANT

來源 PROPVARIANT 結構的參考。

[out] pprgn

類型： USHORT**

當此函式傳回時，包含從來源 PROPVARIANT 結構擷取之不帶正負號簡短值的向量指標。

[out] pcElem

類型： ULONG*

當此函式傳回時，包含從來源 PROPVARIANT 結構擷取的不帶正負號簡短值計數。

傳回值

類型： HRESULT

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

傳回碼	描述
S_OK	如果成功，則傳回 S_OK ，否則傳回錯誤值
E_INVALIDARG	PROPVARIANT 不是適當的類型。

備註

此協助程式函式用於呼叫應用程式預期 PROPVARIANT 保留 不帶正負號簡短 值的向量的位置。

如果來源 PROPVARIANT 的類型VT_VECTOR VT_UI2 | 或VT_ARRAY | VT_UI2，此函式會將不帶正負號的簡短值的向量擷取到新配置的向量。呼叫應用程式負責使用 CoTaskMemFree ，以釋放不再需要時 pprgn 所指向的向量。

範例

下列範例要包含在較大的程式中，示範如何使用 PropVariantToUInt16VectorAlloc 來存取 PROPVARIANT 中不帶正負號的短向量值。

// PROPVARIANT propvar;
// Assume the variable propvar is initialized and valid. The application is expecting propvar to contain a vector of <dtype rid="ushort"/> values.
USHORT *prgShorts;
ULONG cElems;
HRESULT hr = PropVariantToUInt16VectorAlloc(propvar, & prgShorts, &cElems);
if (SUCCEEDED(hr))
{
     // prgShorts now points to a vector of cElems USHORTs.
     CoTaskMemFree(prgShorts);
}

規格需求

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