次の方法で共有

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 構造体への参照。

戻り値

可能な戻り値には、次のものが含まれますが、これらに限定されません。

リターン コード 説明
S_OK
 メソッドは正常に完了しました。
E_INVALIDARG
 pThisDeviceMetadata が NULL、 pThisModelMetadata が NULL、またはいずれかの構造体に必要なメンバーが含まれていません。 必須メンバーの一覧については、パラメーターの説明を参照してください。
E_OUTOFMEMORY
 操作を完了するにはメモリが不足しています。

注釈

このメソッドは、 RegisterService に登録されたデバイス ホストを開始する前に、少なくとも 1 回呼び出す必要があります。 デバイスがメタデータの更新を開始した後に呼び出される場合があります。その場合、新しいメタデータ バージョンを示す Hello メッセージ WS-Discovery が発行されます。

メモ 更新機能はまだ実装されていません。
 

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー wsdhost.h (Wsdapi.h を含む)
[DLL] Wsdapi.dll

こちらもご覧ください

IWSDDeviceHost