IWSDiscoveryPublisher::P ublishEx 메서드(wsddisco.h)

확장된 정보가 포함된 Hello 메시지를 보내 네트워크 호스트의 존재를 알릴 수 있습니다.

구문

HRESULT PublishEx(
  [in]           LPCWSTR              pszId,
  [in]           ULONGLONG            ullMetadataVersion,
  [in]           ULONGLONG            ullInstanceId,
  [in]           ULONGLONG            ullMessageNumber,
  [in, optional] LPCWSTR              pszSessionId,
  [in, optional] const WSD_NAME_LIST  *pTypesList,
  [in, optional] const WSD_URI_LIST   *pScopesList,
  [in, optional] const WSD_URI_LIST   *pXAddrsList,
  [in, optional] const WSDXML_ELEMENT *pHeaderAny,
  [in, optional] const WSDXML_ELEMENT *pReferenceParameterAny,
  [in, optional] const WSDXML_ELEMENT *pPolicyAny,
  [in, optional] const WSDXML_ELEMENT *pEndpointReferenceAny,
  [in, optional] const WSDXML_ELEMENT *pAny
);

매개 변수

[in] pszId

디바이스 엔드포인트 주소로 사용되는 디바이스의 논리적 또는 물리적 주소입니다. 논리적 주소는 형식 urn:uuid:{guid}입니다. 실제 주소는 http 또는 https 접두사로 접두사로 지정된 URI이거나 단순히 에 접두사로 추가된 uriURI일 수 있습니다. 가능하면 논리 주소를 사용합니다.

[in] ullMetadataVersion

현재 메타데이터 버전입니다.

[in] ullInstanceId

게시 중인 디바이스의 현재 instance 대한 식별자입니다. 이 식별자는 서비스를 다시 시작할 때마다 증가해야 합니다. instance 식별자에 대한 자세한 내용은 WS-Discovery 사양의 부록 I를 참조하세요.

[in] ullMessageNumber

현재 메시지에 대한 instance 식별자의 scope 내 카운터입니다. 메시지 번호는 각 메시지에 대해 증가해야 합니다.

[in, optional] pszSessionId

현재 세션에 대한 instance 식별자의 scope 내의 고유 식별자입니다. 이 매개 변수는 프로브 메시지의 AppSequence 블록에 있는 시퀀스 식별자에 해당합니다. 시퀀스 식별자에 대한 자세한 내용은 WS-Discovery 사양의 부록 I를 참조하세요.

이 매개 변수는 NULL일 수 있습니다.

[in, optional] pTypesList

게시 호스트에서 지원하는 형식 목록을 나타내는 WSD_NAME_LIST 구조체에 대한 포인터입니다. NULL일 수 있습니다.

[in, optional] pScopesList

게시 호스트에서 지원하는 일치하는 범위 목록을 나타내는 WSD_URI_LIST 구조체에 대한 포인터입니다. 목록에는 문자열 형식의 해시 값이 포함됩니다. NULL일 수 있습니다.

[in, optional] pXAddrsList

게시 호스트에서 지원하는 전송 주소 목록을 나타내는 WSD_URI_LIST 구조체에 대한 포인터입니다. 각 전송 주소 문자열에는 원격 호스트의 연결에 사용할 수 있는 주소 및 포트 번호가 포함되어 있습니다. NULL일 수 있습니다.

[in, optional] pHeaderAny

헤더의 "ANY" 섹션에 삽입할 XML 요소가 포함된 WSDXML_ELEMENT 구조체에 대한 포인터입니다.

[in, optional] pReferenceParameterAny

참조 매개 변수 속성의 " ANY" 섹션에 삽입할 XML 요소가 포함된 WSDXML_ELEMENT 구조체에 대한 포인터입니다.

[in, optional] pPolicyAny

사용되지 않습니다.

[in, optional] pEndpointReferenceAny

엔드포인트의 "ANY" 섹션에 삽입할 XML 요소가 포함된 WSDXML_ELEMENT 구조체에 대한 포인터입니다.

[in, optional] pAny

메시지 본 문의 " ANY" 섹션에 삽입할 XML 요소가 포함된 WSDXML_ELEMENT 구조체에 대한 포인터입니다.

반환 값

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

설명

성공하면 PublishEx 는 제공된 정보와 함께 로컬 서브넷에 WS-Discovery Hello 메시지를 보냅니다.

WSDXML_ELEMENT 구조를 참조하는 매개 변수를 사용하여 사용자 지정 정보로 전송되는 Hello 메시지의 내용을 확장할 수 있습니다.

요구 사항

참고 항목

IWSDiscoveryPublisher