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

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

  • Статья

Инициализирует структуру PROPVARIANT на основе GUID. Структура инициализируется как VT_LPWSTR.

Синтаксис

PSSTDAPI InitPropVariantFromGUIDAsString(
  [in]  REFGUID     guid,
  [out] PROPVARIANT *ppropvar
);

Параметры

[in] guid

Тип: REFGUID

Ссылка на исходный GUID.

[out] ppropvar

Тип: PROPVARIANT*

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

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

Тип: HRESULT

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

Комментарии

Создает VT_LPWSTR PROPVARIANT, который форматирует GUID в форме, аналогичной {c200e360-38c5-11ce-ae62-08002b2b79ef}.

Примеры

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

PROPVARIANT propvar;

HRESULT hr = InitPropVariantFromGUIDAsString(FMTID_DocSummaryInformation, &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
Библиотека Propsys.lib
DLL Propsys.dll (версия 6.0 или более поздняя)
Распространяемые компоненты Windows Desktop Search (WDS) 3.0

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

InitPropVariantFromCLSID

InitPropVariantFromGUIDAsBuffer

InitVariantFromGUIDAsString

PropVariantToString