PropVariantToDoubleVectorAlloc 函式 (propvarutil.h)
將資料從 PROPVARIANT 結構擷取到新配置的雙向量。
語法
PSSTDAPI PropVariantToDoubleVectorAlloc(
[in] REFPROPVARIANT propvar,
[out] DOUBLE **pprgn,
[out] ULONG *pcElem
);
參數
[in] propvar
類型： REFPROPVARIANT
來源 PROPVARIANT 結構的參考。
[out] pprgn
類型： DOUBLE**
當此函式傳回時，會包含從來源 PROPVARIANT 結構擷取之雙精度浮點數向量的指標。
[out] pcElem
類型： ULONG*
當此函式傳回時，包含從來源 PROPVARIANT 結構擷取的雙精度浮點數。
傳回值
類型： HRESULT
如果此函式成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。
備註
此協助程式函式用於呼叫應用程式預期 PROPVARIANT 保留雙向量值的位置。
如果來源 PROPVARIANT 的類型VT_VECTOR |VT_R8或VT_ARRAY |VT_R8，此函式會將雙精度浮點數向量擷取到新配置的 DOUBLE 值向量。 呼叫應用程式負責使用 CoTaskMemFree ，以釋放不再需要時 pprgn 所指向的向量。
範例
下列範例要包含在較大的程式中，示範如何使用 PropVariantToDoubleVector 來存取 PROPVARIANT中的雙向量值。
// IPropertyStore *ppropstore;
// Assume variable ppropstore is initialized and valid
PROPVARIANT propvar = {0};
HRESULT hr = ppropstore->GetValue(PKEY_GPS_DestLongitude, &propvar);
if (SUCCEEDED(hr))
{
// PKEY_GPS_DestLongitude is expected to produce a VT_VECTOR | VT_R8 with three values, or VT_EMPTY
// PropVariantToDoubleVectorAlloc will return an error for VT_EMPTY
DOUBLE *rgLongitude;
ULONG cElem;
hr = PropVariantToDoubleVectorAlloc(propvar, &rgLongitude, &cElem);
if (SUCCEEDED(hr))
{
if (cElem == 3)
{
// rgLongitude contains 3 doubles representing the degrees, minutes, and seconds of longitude
}
CoTaskMemFree(rgLongitude);
}
else
{
// propvar either is VT_EMPTY, or contains something other than a vector of doubles
}
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 |