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
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Nicht unterstützt |
Zielplattform | Windows |
Kopfzeile | upnphost.h |
DLL | Upnphost.dll |