PropVariantToInt64WithDefault 函式 (propvarutil.h)
擷取PROPVARIANT結構的Int64屬性值。 如果沒有值存在，則會傳回指定的預設值。
語法
PSSTDAPI_(LONGLONG) PropVariantToInt64WithDefault(
[in] REFPROPVARIANT propvarIn,
[in] LONGLONG llDefault
);
參數
[in] propvarIn
類型： REFPROPVARIANT
來源 PROPVARIANT 結構的參考。
[in] llDefault
類型： LONGLONG
指定預設屬性值，用於目前不存在任何值的位置。
傳回值
類型： LONGLONG
傳回擷取的 LONGLONG 值或預設值。
備註
此協助程式函式用於呼叫應用程式預期 PROPVARIANT 保留 LONGLONG 值的位置，而且如果不是，則會使用預設值。 例如，從屬性存放區取得值的應用程式可以使用這個來安全地擷取 Int64 屬性的 LONGLONG 值。
如果來源 PROPVARIANT 的類型 VT_I8，這個協助程式函式會擷取 LONGLONG 值。 否則，它會嘗試將 PROPVARIANT 結構中的值轉換成 LONGLONG。 如果來源PROPVARIANT有類型VT_EMPTY或無法轉換，則 PropVariantToInt64WithDefault 會傳回 llDefault所提供的預設值。 如需可能轉換的清單 ，請參閱 PropVariantChangeType 。
範例
下列範例要包含在較大的程式中，示範如何使用PropVariantToInt64WithDefault來存取PROPVARIANT中的LONGLONG值。
// PROPVARIANT propvar;
// Assume the variable propvar is initialized and valid
// The application is expecting propvar to hold a VT_I8 value, but wishes to treat VT_EMPTY as -1.
LONGLONG llValue = PropVariantToInt64WithDefault(propvar, -1);
// llValue is valid
需求
| 最低支援的用戶端 | Windows XP 搭配 SP2、Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2003 SP1 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | propvarutil.h |
| 程式庫 | Propsys.lib |
| Dll | Propsys.dll (6.0 版或更新版本) |
| 可轉散發套件 | Windows 桌面搜尋 (WDS) 3.0 |