IWSDDeviceHost 인터페이스(wsdhost.h)
DPWS 규격 디바이스 를 나타냅니다. 디바이스 호스트는 WS-Discovery 프로토콜을 사용하여 네트워크에서 현재 상태를 알려 줍니다. 또한 디바이스 호스트는 검색 쿼리 및 메타데이터 요청에 자동으로 응답합니다.
호출자는 디바이스 호스트에 사용자 구현 서비스를 등록할 수 있습니다. 이러한 서비스는 디바이스 메타데이터에 노출되고 서비스는 네트워크를 통해 사용할 수 있습니다. 이러한 서비스에 바인딩된 메시지는 서비스 개체로 자동으로 디스패치됩니다.
WSDCreateDeviceHost 또는 WSDCreateDeviceHostAdvanced를 호출하여 이 인터페이스를 노출하는 개체를 만듭니다.
상속
IWSDDeviceHost 인터페이스는 IUnknown 인터페이스에서 상속됩니다. IWSDDeviceHost 에는 다음과 같은 유형의 멤버도 있습니다.
메서드
IWSDDeviceHost 인터페이스에는 이러한 메서드가 있습니다.
| IWSDDeviceHost::AddDynamicService 들어오는 요청에 대한 서비스 개체를 등록하지만 디바이스 호스트 메타데이터에 서비스를 추가하지는 않습니다. 일시적(동적) 서비스에 사용됩니다. |
| IWSDDeviceHost::Init IWSDDeviceHost 개체의 instance 초기화합니다. |
| IWSDDeviceHost::RegisterPortType 들어오는 메시지에 대한 포트 형식을 등록합니다. |
| IWSDDeviceHost::RegisterService 들어오는 요청에 대한 서비스 개체를 등록하고 디바이스 호스트 메타데이터에 서비스를 추가합니다. |
| IWSDDeviceHost::RemoveDynamicService AddDynamicService를 사용하여 등록된 서비스 개체의 등록을 취소합니다. |
| IWSDDeviceHost::RetireService RegisterService를 사용하여 등록된 서비스 개체의 등록을 취소하고 디바이스 호스트 메타데이터에서 서비스를 제거합니다. |
| IWSDDeviceHost::SetMetadata 사용자 정의 서비스 메타데이터를 제외한 디바이스에 대한 메타데이터를 설정합니다. |
| IWSDDeviceHost::SetServiceDiscoverable WS-Discovery를 사용하여 서비스를 보급할지 여부를 제어합니다. |
| IWSDDeviceHost::SignalEvent 모든 구독된 클라이언트에 이벤트가 발생했음을 알 수 있습니다. |
| IWSDDeviceHost::Start 디바이스 호스트를 시작하고 WS-Discovery Hello 메시지를 사용하여 디바이스 호스트를 게시합니다. |
| IWSDDeviceHost::Stop WS-Discovery Bye 메시지를 보내고 호스트를 중지합니다. |
| IWSDDeviceHost::Terminate 호스트를 종료하고 연결된 서비스를 해제합니다. |
설명
이 인터페이스를 검색한 후 애플리케이션은 다음을 수행합니다.
- RegisterPortType 메서드를 호출하여 필요한 모든 포트 형식을 등록합니다.
- SetMetadata를 호출하여 디바이스를 설명하고 필요에 따라 RegisterService를 한 번 이상 호출하여 서비스 호스트 메타데이터에 설명된 서비스를 등록합니다.
- Start 메서드를 호출하여 디바이스 호스트를 시작하고 WS-Discovery를 사용하여 디바이스를 게시합니다.디바이스 호스트를 시작한 후 필요에 따라 다음을 수행할 수 있습니다.
- 서비스 호스트 메타데이터(예: 임시 인쇄 작업)에 설명되지 않은 서비스에 대해 AddDynamicService 를 호출합니다.
- RetireService를 호출하여 작업을 종료하고 RegisterService 메서드에서 활성화된 서비스의 연결을 끊습니다.
- SignalEvent 메서드를 호출하여 특정 이벤트와 관련된 구독에 대한 알림을 보내야 함을 나타냅니다.
- Stop 메서드를 호출하여 호스트 실행을 종료하고 디바이스 게시를 종료합니다.
IWSDDeviceHost 개체는 호스트가 해당 서비스를 대상으로 하는 요청 메시지를 수신할 때 요청 시(알림 콜백 사용) 서비스에 대한 개체를 제공할 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | wsdhost.h(Wsdapi.h 포함) |