Функция PropVariantToInt64WithDefault (propvarutil.h)
Извлекает значение свойства Int64 структуры PROPVARIANT . Если значение не существует, возвращается указанное значение по умолчанию.
Синтаксис
PSSTDAPI_(LONGLONG) PropVariantToInt64WithDefault(
[in] REFPROPVARIANT propvarIn,
[in] LONGLONG llDefault
);
Параметры
[in] propvarIn
Тип: REFPROPVARIANT
Ссылка на исходную структуру PROPVARIANT .
[in] llDefault
Тип: LONGLONG
Задает значение свойства по умолчанию для использования, если значение в настоящее время не существует.
Возвращаемое значение
Тип: LONGLONG
Возвращает извлеченное значение LONGLONG или значение по умолчанию.
Комментарии
Эта вспомогательная функция используется в тех местах, где вызывающее приложение ожидает , что PROPVARIANT будет содержать значение LONGLONG , и в противном случае будет использовать значение по умолчанию. Например, приложение, получающее значения из хранилища свойств, может использовать его для безопасного извлечения значения LONGLONG для свойств Int64.
Если исходный PROPVARIANT имеет тип VT_I8, эта вспомогательская функция извлекает значение LONGLONG . В противном случае он пытается преобразовать значение в структуре PROPVARIANT в longlong. Если исходный PROPVARIANT имеет тип VT_EMPTY или преобразование невозможно, PropVariantToInt64WithDefault вернет значение по умолчанию, предоставленное llDefault. Список возможных преобразований см. в разделе PropVariantChangeType .
Примеры
В следующем примере, который будет включен в более крупную программу, показано, как использовать PropVariantToInt64WithDefault для доступа к значению LONGLONG в PROPVARIANT.
// 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 с пакетом обновления 2 (SP2), Windows Vista [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 с пакетом обновления 1 (SP1) [только классические приложения] |
| Целевая платформа | Windows |
| Header | propvarutil.h |
| Библиотека | Propsys.lib |
| DLL | Propsys.dll (версия 6.0 или более поздняя) |
| Распространяемые компоненты | Windows Desktop Search (WDS) 3.0 |