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


Функция CLSIDFromProgID (combaseapi.h)

Выполняет поиск идентификатора CLSID в реестре с учетом идентификатора ProgID.

Синтаксис

HRESULT CLSIDFromProgID(
  [in]  LPCOLESTR lpszProgID,
  [out] LPCLSID   lpclsid
);

Параметры

[in] lpszProgID

Указатель на идентификатор ProgID, clSID которого запрашивается.

[out] lpclsid

Получает указатель на полученный идентификатор CLSID при возврате.

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

Эта функция может возвращать следующие значения.

Код возврата Описание
S_OK
Идентификатор CLSID успешно получен.
CO_E_CLASSSTRING
Зарегистрированный идентификатор CLSID для ProgID недопустим.
REGDB_E_WRITEREGDB
Произошла ошибка при записи CLSID в реестр. См. примечания ниже.

Комментарии

При использовании ProgID CLSIDFromProgID ищет соответствующий идентификатор CLSID в реестре. Если идентификатор ProgID не найден в реестре, clSIDFromProgID создает CLSID OLE 1 для ProgID и запись CLSID в реестре. Из-за ограничений, накладываемых на значения CLSID OLE 1, CLSIDFromProgID и CLSIDFromString являются единственными двумя функциями, которые можно использовать для создания CLSID для объекта OLE 1.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header combaseapi.h (включая Objbase.h)
Библиотека Ole32.lib
DLL Ole32.dll

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

CLSIDFromProgIDEx

ProgIDFromCLSID