Поделиться через


Функция 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