WSDCreateDeviceHost 함수(wsdhost.h)

디바이스 호스트를 만들고 IWSDDeviceHost 인터페이스에 대한 포인터를 반환합니다.

구문

HRESULT WSDCreateDeviceHost(
  [in]  LPCWSTR        pszLocalId,
  [in]  IWSDXMLContext *pContext,
  [out] IWSDDeviceHost **ppDeviceHost
);

매개 변수

[in] pszLocalId

디바이스의 논리적 또는 물리적 주소입니다. 논리적 주소는 형식 urn:uuid:{guid}입니다. pszLocalId가 논리적 주소인 경우 호스트는 논리 주소를 알리고 해결 또는 프로브 메시지를 받을 때 주소를 실제 주소로 변환합니다.

pszLocalId가 실제 주소(예: http 또는 https로 접두사로 지정된 URL)인 경우 호스트는 주소를 실제 주소로 사용하고 기본 주소 대신 해당 주소에서 호스트합니다.

보안 통신의 경우 pszLocalId 는 https 접두사 URL이어야 하며 호스트는 URL에 지정된 포트에서 SSL/TLS 프로토콜을 사용합니다. 이 포트는 WSDAPI와의 보안 연결을 위해 예약되어 있으므로 권장 포트는 포트 5358입니다. 포트가 지정되지 않은 경우 호스트는 포트 443을 사용합니다. WSDCreateDeviceHost를 호출하기 전에 호스트 포트를 SSL 서버 인증서로 구성해야 합니다. 호스트 포트 구성에 대한 자세한 내용은 HttpSetServiceConfiguration을 참조하세요.

모든 URL(http 또는 https)은 후행 슬래시로 종료해야 합니다. URL에는 유효한 IP 주소 또는 호스트 이름이 포함되어야 합니다.

다음 목록에서는 pszLocalId에 대한 몇 가지 예제 값을 보여 줍니다. 유효한 값의 전체 목록이 아닙니다.

• http://192.168.0.1:5357/
• http://localhost/
• http://myHostname:5357/
• https://192.168.0.1:5358/
• https://myHostname/
• https://myHostname/myDevice/
• https://myHostname:5358/

[in] pContext

사용자 지정 메시지 형식 또는 네임스페이스를 정의하는 IWSDXMLContext 개체입니다.

NULL인 경우 기본 제공 메시지 형식 및 네임스페이스를 나타내는 기본 컨텍스트가 사용됩니다.

[out] ppDeviceHost

들어오는 요청에 응답하는 서버와 연결된 WSD 관련 디바이스 의미 체계를 노출하는 데 사용하는 IWSDDeviceHost 개체에 대한 포인터입니다.

반환 값

가능한 반환 값에는 다음이 포함되지만 이에 국한되지는 않습니다.

설명

WSDCreateDeviceHost 함수는 IWSDDeviceHost 개체의 instance 초기화하는 IWSDDeviceHost::Init 메서드를 호출합니다.

요구 사항

참고 항목

WSDCreateDeviceHostAdvanced