Metodo IUPnPDeviceControl::GetServiceObject (upnphost.h)
Il metodo GetServiceObject viene usato per ottenere il puntatore IDispatch a un oggetto servizio specifico. L'host del dispositivo richiama questo metodo una volta per servizio, la prima volta che riceve una richiesta per un servizio.
Sintassi
HRESULT GetServiceObject(
[in] BSTR bstrUDN,
[in] BSTR bstrServiceId,
[out] IDispatch **ppdispService
);
Parametri
[in] bstrUDN
Specifica l'UDN del dispositivo.
[in] bstrServiceId
Specifica l'ID servizio del servizio per il quale ottenere il puntatore.
[out] ppdispService
Riceve il puntatore IDispatch all'oggetto servizio.
Valore restituito
Quando si implementa questo metodo, restituire S_OK se il metodo ha esito positivo. In caso contrario, restituire uno dei codici di errore COM definiti in WinError.h.
Commenti
Questo metodo viene richiamato dall'host del dispositivo quando viene ricevuta una richiesta di controllo o una sottoscrizione di eventi per un determinato servizio.
I dispositivi incorporati sono differenziati in base ai nomi definiti dall'utente.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP [solo app desktop] |
| Server minimo supportato | Nessuno supportato |
| Piattaforma di destinazione | Windows |
| Intestazione | upnphost.h |
| DLL | Upnphost.dll |