Interfaccia IWSDDeviceHost (wsdhost.h)
Rappresenta un dispositivo conforme a DPWS. L'host del dispositivo annuncia la sua presenza in rete usando il protocollo WS-Discovery. L'host del dispositivo risponderà automaticamente anche alle query di individuazione e alle richieste di metadati.
Il chiamante può registrare i servizi implementati dall'utente con l'host del dispositivo. Questi servizi verranno esposti nei metadati del dispositivo e i servizi saranno disponibili in rete. I messaggi associati a questi servizi verranno inviati automaticamente all'oggetto servizio.
Chiamare WSDCreateDeviceHost o WSDCreateDeviceHostAdvanced per creare un oggetto che espone questa interfaccia.
Ereditarietà
L'interfaccia IWSDDeviceHost eredita dall'interfaccia IUnknown . IWSDDeviceHost include anche questi tipi di membri:
Metodi
L'interfaccia IWSDDeviceHost include questi metodi.
| IWSDDeviceHost::AddDynamicService Registra un oggetto servizio per le richieste in ingresso, ma non aggiunge il servizio ai metadati dell'host del dispositivo. Viene usato per i servizi temporanei (dinamici). |
| IWSDDeviceHost::Init Inizializza un'istanza di un oggetto IWSDDeviceHost. |
| IWSDDeviceHost::RegisterPortType Registra un tipo di porta per i messaggi in arrivo. |
| IWSDDeviceHost::RegisterService Registra un oggetto servizio per le richieste in ingresso e aggiunge il servizio ai metadati dell'host del dispositivo. |
| IWSDDeviceHost::RemoveDynamicService Annulla la registrazione di un oggetto servizio registrato con AddDynamicService. |
| IWSDDeviceHost::RetireService Annulla la registrazione di un oggetto servizio registrato tramite RegisterService e rimuove il servizio dai metadati dell'host del dispositivo. |
| IWSDDeviceHost::SetMetadata Imposta i metadati per un dispositivo, esclusi i metadati del servizio definiti dall'utente. |
| IWSDDeviceHost::SetServiceDiscoverable Controlla se il servizio viene annunciato tramite WS-Discovery. |
| IWSDDeviceHost::SignalEvent Notifica a tutti i client sottoscritti che si è verificato un evento. |
| IWSDDeviceHost::Start Avvia l'host del dispositivo e pubblica l'host del dispositivo usando un messaggio Hello WS-Discovery. |
| IWSDDeviceHost::Stop Invia un messaggio di WS-Discovery Bye e arresta l'host. |
| IWSDDeviceHost::Terminate Termina l'host e rilascia tutti i servizi collegati. |
Commenti
Dopo aver recuperato questa interfaccia, l'applicazione avrebbe quindi:
- Chiamare il metodo RegisterPortType per registrare tutti i tipi di porta necessari.
- Chiamare SetMetadata per descrivere il dispositivo e, facoltativamente, chiamare RegisterService una o più volte per registrare i servizi descritti nei metadati dell'host del servizio.
- Chiamare il metodo Start per avviare l'host del dispositivo e pubblicare il dispositivo usando WS-Discovery.Dopo aver avviato l'host del dispositivo, è possibile facoltativamente:
- Chiamare AddDynamicService per i servizi non descritti nei metadati dell'host del servizio, ad esempio un processo di stampa ad hoc.
- Chiamare RetireService per terminare l'azione su e disconnettere un servizio attivato dal metodo RegisterService .
- Chiamare il metodo SignalEvent per indicare che le notifiche devono essere inviate per le sottoscrizioni relative a un determinato evento.
- Chiamare il metodo Stop per terminare l'esecuzione dell'host e terminare la pubblicazione del dispositivo.
Un oggetto IWSDDeviceHost può fornire un oggetto per un servizio su richiesta (tramite un callback di notifica) quando chiama l'host riceve un messaggio di richiesta diretto a tale servizio.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2008 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | wsdhost.h (include Wsdapi.h) |