VariantToDoubleWithDefault 函式 (propvarutil.h)
從 VARIANT 結構擷取 DOUBLE 值。 如果沒有值存在,則會傳回指定的預設值。
語法
PSSTDAPI_(DOUBLE) VariantToDoubleWithDefault(
[in] REFVARIANT varIn,
[in] DOUBLE dblDefault
);
參數
[in] varIn
類型: REFVARIANT
來源 VARIANT 結構的參考。
[in] dblDefault
類型: DOUBLE
默認值,用於沒有可擷取值的位置。
傳回值
類型: DOUBLE
傳回擷取的 雙精度 浮點數;否則,在 dblDefault 中指定的預設值。
備註
當呼叫的應用程式預期 VARIANT 保留 DOUBLE 值,而且若未使用預設值,就會使用此協助程式函式。
如果來源 VARIANT 的類型為 VT_R8,此協助程式會擷取 DOUBLE 值。
如果來源 VARIANT 的類型不是 VT_R8,函式會嘗試將 VARIANT 中的值轉換成 DOUBLE。
如果來源 VARIANT 的類型為VT_EMPTY或無法轉換,則 VariantToDoubleWithDefault 會傳回 dblDefault 所提供的預設值。 如需可能的轉換清單,請參閱 PropVariantChangeType 。
範例
下列範例要包含在較大的程式中,示範如何使用 VariantToDoubleWithDefault 來存取 VARIANT 結構中儲存的 DOUBLE 值。
// VARIANT var;
// Assume variable var is initialized and valid.
// The application expects var to hold a DOUBLE value.
// The application wants to treat VT_EMPTY as 3.1415.
DOUBLE dblValue = VariantToDoubleWithDefault(var, 3.1415);
// dblValue is now valid.
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows XP 搭配 SP2、Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 SP1 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | propvarutil.h |
程式庫 | Propsys.lib |
Dll | Propsys.dll (6.0 版或更新版本) |
可轉散發套件 | Windows 桌面搜尋 (WDS) 3.0 |