Функция PropVariantToVariant (propvarutil.h)
Преобразует содержимое структуры PROPVARIANT в структуру VARIANT .
Синтаксис
PSSTDAPI PropVariantToVariant(
[in] const PROPVARIANT *pPropVar,
[out] VARIANT *pVar
);
Параметры
[in] pPropVar
Тип: const PROPVARIANT*
Указатель на исходную структуру PROPVARIANT .
[out] pVar
Тип: VARIANT*
Указатель на структуру VARIANT . При возврате этой функции variant содержит преобразованные сведения.
Возвращаемое значение
Тип: HRESULT
Если эта функция завершается успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT .
Комментарии
Обычно данные, хранящиеся в PROPVARIANT , копируются в VARIANT без изменения типа данных. Однако в следующих случаях отсутствует прямая поддержка variant для типа данных, и они преобразуются, как показано ниже.
Исходный тип PROPVARIANT | Хранится как тип VARIANT |
---|---|
VT_BLOB, VT_STREAM | VT_UNKNOWN. Элемент punkVal будет содержать указатель на IStream , содержащий исходные данные. |
VT_LPSTR, VT_LPWSTR, VT_CLSID | VT_BSTR |
VT_FILETIME | VT_DATE |
VT_VECTOR|x | VT_ARRAY|y |
Следующие типы не могут быть преобразованы с помощью этой функции.
- VT_STORAGE
- VT_BLOB_OBJECT
- VT_STREAMED_OBJECT
- VT_STORED_OBJECT
- VT_CF
- VT_VECTOR | VT_CF
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows Vista, Windows XP с пакетом обновления 2 (SP2) [только классические приложения] |
Минимальная версия сервера | Windows Server 2003 с пакетом обновления 1 (SP1) [только классические приложения] |
Целевая платформа | Windows |
Header | propvarutil.h |
Библиотека | Propsys.lib |
DLL | Propsys.dll (версия 6.0 или более поздняя) |
Распространяемые компоненты | Windows Desktop Search (WDS) 3.0 |