Méthode IUPnPDeviceControl ::GetServiceObject (upnphost.h)
La méthode GetServiceObject est utilisée pour obtenir le pointeur IDispatch vers un objet de service spécifique. L’hôte de l’appareil appelle cette méthode une fois par service, la première fois qu’il reçoit une demande pour un service.
Syntaxe
HRESULT GetServiceObject(
[in] BSTR bstrUDN,
[in] BSTR bstrServiceId,
[out] IDispatch **ppdispService
);
Paramètres
[in] bstrUDN
Spécifie l’UDN de l’appareil.
[in] bstrServiceId
Spécifie l’ID de service du service pour lequel obtenir le pointeur.
[out] ppdispService
Reçoit le pointeur IDispatch vers l’objet de service.
Valeur retournée
Lors de l’implémentation de cette méthode, retournez S_OK si la méthode réussit. Sinon, retournez l’un des codes d’erreur COM définis dans WinError.h.
Remarques
Cette méthode est appelée par l’hôte de l’appareil lorsqu’une demande de contrôle ou un abonnement à un événement est reçu pour un service particulier.
Les appareils incorporés se distinguent par leurs noms de noms de domaine.
Configuration requise
| Condition requise | Valeur |
|---|---|
| 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 |