Partager via


IUPnPRegistrar::RegisterDeviceProvider, méthode (upnphost.h)

La méthode RegisterDeviceProvider inscrit un fournisseur d’appareil auprès de l’hôte de l’appareil. Le fournisseur d’appareils n’est pas publié sur le réseau. Au lieu de cela, il crée des appareils dynamiquement et les inscrit à l’aide de RegisterRunningDevice.

Syntaxe

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

Paramètres

[in] bstrProviderName

Spécifie le nom du fournisseur d’appareil.

[in] bstrProgIDProviderClass

Spécifie le ProgID de l’objet qui implémente l’interface IUPnPDeviceProvider . Cet objet doit déjà être inscrit auprès de COM. Cet objet doit être un serveur COM in-process (CLSCTX_INPROC_SERVER) et doit être accessible à LocalService.

[in] bstrInitString

Identifie une chaîne d’initialisation spécifique à un fournisseur d’appareil.

[in] bstrContainerId

Spécifie une chaîne qui identifie le groupe de processus auquel appartient le fournisseur d’appareil. Tous les appareils et fournisseurs d’appareils avec le même ID de conteneur sont contenus dans le même processus.

Valeur retournée

Si la méthode réussit, la valeur de retour est S_OK. Sinon, la méthode retourne l’un des codes d’erreur COM définis dans WinError.h.

Remarques

Les erreurs courantes qui peuvent se produire lors de l’appel de cette fonction sont les suivantes :

  • L’objet COM nécessaire est introuvable.
  • Il n’existe aucun accès à l’objet COM pour LocalService.
  • Interfaces COM subordonnées.

Configuration requise

   
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Aucun pris en charge
Plateforme cible Windows
En-tête upnphost.h
DLL Upnphost.dll

Voir aussi

IUPnPRegistrar

IUPnPRegistrar::UnregisterDeviceProvider