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

Статья
08/22/2023

Выполняет поиск идентификатора 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

Share via