IWSDDeviceHost::Init 메서드(wsdhost.h)

디바이스의 호스트 쪽 표현인 IWSDDeviceHost 개체의 instance 초기화합니다.

구문

HRESULT Init(
  [in]           LPCWSTR        pszLocalId,
  [in, optional] IWSDXMLContext *pContext,
  [in, optional] IWSDAddress    **ppHostAddresses,
  [in, optional] DWORD          dwHostAddressCount
);

매개 변수

[in] pszLocalId

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

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

보안 통신의 경우 pszLocalId 는 https 접두사 URL이어야 하며 호스트는 URL에 지정된 포트에서 SSL/TLS 프로토콜을 사용합니다. 이 포트는 WSDAPI와의 보안 연결을 위해 예약되어 있으므로 권장 포트는 포트 5358입니다. 포트가 지정되지 않은 경우 호스트는 포트 443을 사용합니다. 호스트 포트는 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, optional] pContext

사용자 지정 메시지 유형 또는 네임스페이스를 정의하는 IWSDXMLContext 인터페이스입니다.

[in, optional] ppHostAddresses

단일 IWSDAddress 개체 또는 IWSDTransportAddress 개체입니다. 개체는 호스트가 수신 대기해야 하는 특정 주소에 대한 정보를 제공합니다.

pszLocalId에 로컬 주소가 포함된 경우 결과 동작은 논리 주소와 기본 실제 주소 간의 매핑 대신 논리 주소와 제공된 실제 주소 간의 매핑입니다.

[in, optional] dwHostAddressCount

ppHostAddresses 배열의 항목 수입니다. ppHostAddresses가 IWSDAddress 인터페이스인 경우 개수는 1이어야 합니다.

반환 값

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

설명

이 메서드는 WSDCreateDeviceHost 에서 호출되며 일반적으로 코드에서 직접 호출할 필요가 없습니다.

요구 사항

추가 정보

IWSDDeviceHost