IUPnPDeviceControl::GetServiceObject-Methode (upnphost.h)

Die GetServiceObject-Methode wird verwendet, um den IDispatch-Zeiger auf ein bestimmtes Dienstobjekt abzurufen. Der Gerätehost ruft diese Methode einmal pro Dienst auf, wenn er zum ersten Mal eine Anforderung für einen Dienst empfängt.

Syntax

HRESULT GetServiceObject(
  [in]  BSTR      bstrUDN,
  [in]  BSTR      bstrServiceId,
  [out] IDispatch **ppdispService
);

Parameter

[in] bstrUDN

Gibt den UDN des Geräts an.

[in] bstrServiceId

Gibt die Dienst-ID des Diensts an, für den der Zeiger abgerufen werden soll.

[out] ppdispService

Empfängt den IDispatch-Zeiger auf das Dienstobjekt.

Rückgabewert

Geben Sie bei der Implementierung dieser Methode S_OK zurück, wenn die Methode erfolgreich ist. Andernfalls geben Sie einen der in WinError.h definierten COM-Fehlercodes zurück.

Hinweise

Diese Methode wird vom Gerätehost aufgerufen, wenn eine Steuerelementanforderung oder ein Ereignisabonnement für einen bestimmten Dienst empfangen wird.

Eingebettete Geräte unterscheiden sich durch ihre UDNs.

Anforderungen

Weitere Informationen

IUPnPDeviceControl

Initialisieren