Функция InitPropVariantVectorFromPropVariant (propvarutil.h)

Статья
03/05/2024

Инициализирует элемент вектора в структуре PROPVARIANT со значением, хранящимся в другом PROPVARIANT.

Синтаксис

PSSTDAPI InitPropVariantVectorFromPropVariant(
  [in]  REFPROPVARIANT propvarSingle,
  [out] PROPVARIANT    *ppropvarVector
);

Параметры

[in] propvarSingle

Тип: REFPROPVARIANT

Ссылка на исходную структуру PROPVARIANT , содержащую одно значение.

[out] ppropvarVector

Тип: PROPVARIANT*

При возврате этой функции содержит инициализированную структуру PROPVARIANT .

Возвращаемое значение

Тип: HRESULT

Если эта функция выполняется успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Для источника, содержащего строку, эта функция инициализирует PROPVARIANT с нулевыми или более подстроками, взятыми из исходной строки, рассматривая точки с запятой как разделители. Дополнительные сведения см. в разделе InitPropVariantFromStringAsVector .

Поддерживаются следующие типы входных данных.

VT_I2
VT_UI2
VT_I4
VT_UI4
VT_I8
VT_UI8
VT_R8
VT_BOOL.
VT_DATE
VT_FILETIME
VT_BSTR
VT_LPWSTR

В будущем могут поддерживаться дополнительные типы.

Примеры

В следующем примере, который будет включен в состав более крупной программы, показано, как использовать InitPropVariantVectorFromPropVariant.

// PROPVARIANT propvarSource;
// Assume propvarSource is initialized and valid.

if (PropVariantGetElementCount(propvarSource) == 1)
{
    PROPVARIANT propvar;

    HRESULT hr = InitPropVariantVectorFromPropVariant(propvarSource, &propvar);

    if (SUCCEEDED(hr))
    {
       // propvar now is valid and is either VT_EMPTY or contains a vector.
       PropVariantClear(&propvar);
    }

Требования

Требование	Значение
Минимальная версия клиента	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

См. также раздел

InitPropVariantFromStringAsVector

PropVariantGetElem

PropVariantGetElementCount

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