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

Инициализирует структуру PROPVARIANT на основе указанной строки.

Синтаксис

HRESULT InitPropVariantFromString(
  [in]  PCWSTR      psz,
  [out] PROPVARIANT *ppropvar
);

Параметры

[in] psz

Тип: PCWSTR

Указатель на буфер, содержащий исходную строку Юникода.

[out] ppropvar

Тип: PROPVARIANT*

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

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

Тип: HRESULT

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

Комментарии

Это встроенная функция с исходным кодом, указанным в заголовке . Он не включается в .dll или LIB-файл.

Примеры

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

PROPVARIANT propvar;
HRESULT hr = InitPropVariantFromString(L"Hello World", &propvar);

if (SUCCEEDED(hr))
{
    // propvar now is valid and has type VT_LPWSTR.
    PropVariantClear(&propvar);
}

Требования

Требование Значение
Минимальная версия клиента Windows XP с пакетом обновления 2 (SP2), Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2003 с пакетом обновления 1 (SP1) [только классические приложения]
Целевая платформа Windows
Header propvarutil.h
Распространяемые компоненты Windows Desktop Search (WDS) 3.0

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

InitPropVariantFromStringAsVector

InitPropVariantFromStringVector

InitVariantFromString

PropVariantToString

PropVariantToStringWithDefault