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

사용자 정의 서비스 메타데이터를 제외한 디바이스에 대한 메타데이터를 설정합니다.

구문

HRESULT SetMetadata(
  [in]           const WSD_THIS_MODEL_METADATA   *pThisModelMetadata,
  [in]           const WSD_THIS_DEVICE_METADATA  *pThisDeviceMetadata,
  [in, optional] const WSD_HOST_METADATA         *pHostMetadata,
  [in, optional] const WSD_METADATA_SECTION_LIST *pCustomMetadata
);

매개 변수

[in] pThisModelMetadata

이 디바이스 모델의 모든 인스턴스에 공통적인 메타데이터를 지정하는 WSD_THIS_MODEL_METADATA 구조체에 대한 참조입니다. 구조체의 Manufacturer, ModelNames 및 ModelNumber 멤버에는 NULL이 아닌 비어 있지 않은 항목이 포함되어야 합니다.

[in] pThisDeviceMetadata

이 디바이스에 고유한 메타데이터를 지정하는 WSD_THIS_DEVICE_METADATA 구조체에 대한 참조입니다. 이 구조 체의 FriendlyName, FirmwareVersion 및 SerialNumber 멤버에는 NULL이 아닌 비어 있지 않은 항목이 포함되어야 합니다.

[in, optional] pHostMetadata

서비스 호스트 메타데이터를 지정하는 WSD_HOST_METADATA 구조체에 대한 참조로, 디바이스의 특정 데이터 및 특성(예: 프린터에서 색을 지원하거나 스테이플러가 있는 경우)입니다.

[in, optional] pCustomMetadata

이 디바이스와 연결된 추가 사용자 지정 메타데이터를 지정하는 WSD_METADATA_SECTION_LIST 구조체에 대한 참조입니다.

반환 값

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

설명

RegisterService에 등록된 디바이스 호스트를 시작하기 전에 이 메서드를 한 번 이상 호출해야 합니다. 디바이스가 메타데이터를 업데이트하기 시작한 후 호출될 수 있습니다. 이 경우 새 메타데이터 버전을 나타내는 WS-Discovery Hello 메시지가 발급됩니다.

요구 사항

추가 정보

IWSDDeviceHost