Метод IUPnPRegistrar::RegisterDeviceProvider (upnphost.h)

Метод RegisterDeviceProvider регистрирует поставщика устройств на узле устройства. Поставщик устройства не опубликован в сети. Вместо этого он динамически создает устройства и регистрирует их с помощью RegisterRunningDevice.

Синтаксис

HRESULT RegisterDeviceProvider(
  [in] BSTR bstrProviderName,
  [in] BSTR bstrProgIDProviderClass,
  [in] BSTR bstrInitString,
  [in] BSTR bstrContainerId
);

Параметры

[in] bstrProviderName

Указывает имя поставщика устройства.

[in] bstrProgIDProviderClass

Указывает ProgID объекта , реализующего интерфейс IUPnPDeviceProvider . Этот объект уже должен быть зарегистрирован в COM. Этот объект должен быть внутрипроцессным COM-сервером (CLSCTX_INPROC_SERVER) и должен быть доступен для LocalService.

[in] bstrInitString

Определяет строку инициализации, относяющуюся к поставщику устройства.

[in] bstrContainerId

Задает строку, определяющую группу процессов, в которую входит поставщик устройств. Все устройства и поставщики устройств с одинаковым идентификатором контейнера содержатся в одном процессе.

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

Если метод выполнен успешно, возвращаемое значение будет S_OK. В противном случае метод возвращает один из кодов com-ошибок, определенных в WinError.h.

Комментарии

Распространенные ошибки, которые могут возникнуть при вызове этой функции:

• Необходимый COM-объект не найден.
• Доступ к COM-объекту для LocalService отсутствует.
• Подчиненные COM-интерфейсы.

Требования

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

IUPnPRegistrar

IUPnPRegistrar::UnregisterDeviceProvider