IUPnPRegistrar::RegisterDeviceProvider-Methode (upnphost.h)

Die RegisterDeviceProvider-Methode registriert einen Geräteanbieter beim Gerätehost. Der Geräteanbieter wird nicht im Netzwerk veröffentlicht. Stattdessen werden Geräte dynamisch erstellt und mithilfe von RegisterRunningDevice registriert.

Syntax

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

Parameter

[in] bstrProviderName

Gibt den Namen des Geräteanbieters an.

[in] bstrProgIDProviderClass

Gibt die ProgID des Objekts an, das die IUPnPDeviceProvider-Schnittstelle implementiert. Dieses Objekt muss bereits bei COM registriert sein. Dieses Objekt muss ein prozessinterner COM-Server (CLSCTX_INPROC_SERVER) sein und für LocalService zugänglich sein.

[in] bstrInitString

Identifiziert eine Initialisierungszeichenfolge, die für einen Geräteanbieter spezifisch ist.

[in] bstrContainerId

Gibt eine Zeichenfolge an, die die Prozessgruppe identifiziert, zu der der Geräteanbieter gehört. Alle Geräte und Geräteanbieter mit derselben Container-ID sind im gleichen Prozess enthalten.

Rückgabewert

Wenn die Methode erfolgreich ist, wird der Rückgabewert S_OK. Andernfalls gibt die Methode einen der com-Fehlercodes zurück, die in WinError.h definiert sind.

Hinweise

Häufige Fehler, die beim Aufrufen dieser Funktion auftreten können, sind:

• Das erforderliche COM-Objekt wurde nicht gefunden.
• Es gibt keinen Zugriff auf das COM-Objekt für LocalService.
• Untergeordnete COM-Schnittstellen.

Anforderungen

Weitere Informationen

IUPnPRegistrar

IUPnPRegistrar::UnregisterDeviceProvider