次の方法で共有

IWSDiscoveryPublisher::UnPublish メソッド (wsddisco.h)

  • [アーティクル]

Bye メッセージを送信して、ネットワーク ホストの出発を読み上げる。

構文

HRESULT UnPublish(
  [in]           LPCWSTR              pszId,
  [in]           ULONGLONG            ullInstanceId,
  [in]           ULONGLONG            ullMessageNumber,
  [in, optional] LPCWSTR              pszSessionId,
  [in, optional] const WSDXML_ELEMENT *pAny
);

パラメーター

[in] pszId

デバイスのエンドポイント アドレスとして使用される、デバイスの論理アドレスまたは物理アドレス。 論理アドレスは という形式 urn:uuid:{guid}です。 物理アドレスには、http または https でプレフィックスが付いた URI、または 単に によってプレフィックスが付いた uriURI を指定できます。 可能な限り、論理アドレスを使用します。

[in] ullInstanceId

公開されているデバイスの現在のインスタンスの識別子。 この識別子は、サービスが再起動されるたびにインクリメントする必要があります。 インスタンス識別子の詳細については、 WS-Discovery 仕様の付録 I を参照してください。

メモWS-Discovery 仕様との互換性を保つには、この値を UINT_MAX (4294967295) 以下にする必要があります。
 

[in] ullMessageNumber

現在のメッセージのインスタンス識別子のスコープ内のカウンター。 メッセージ番号は、メッセージごとにインクリメントする必要があります。

メモWS-Discovery 仕様との互換性を保つには、この値を UINT_MAX (4294967295) 以下にする必要があります。
 

[in, optional] pszSessionId

現在のセッションのインスタンス識別子のスコープ内の一意識別子。 このパラメーターは、Probe メッセージの AppSequence ブロック内のシーケンス識別子に対応します。 シーケンス識別子の詳細については、 WS-Discovery 仕様の付録 I を参照してください。

このパラメーターには NULL を指定できます。

[in, optional] pAny

メッセージ 本文の " ANY" セクションに挿入する XML 要素を含むWSDXML_ELEMENT構造体へのポインター。

戻り値

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

リターン コード 説明
S_OK
 メソッドは正常に完了しました。
E_INVALIDARG
 次の条件のうち 1 つ以上が当てはまります。
  • pszId は NULL です。
  • pszId の長さがWSD_MAX_TEXT_LENGTH (8192) を超えています。
  • pszSessionId の長さがWSD_MAX_TEXT_LENGTH (8192) を超えています。
E_ABORT
 発行元が開始されていません。 通知シンクをアタッチすると、パブリッシャーが起動します。 シンクをアタッチするには、 RegisterNotificationSink を呼び出します。
E_OUTOFMEMORY
 操作を完了するにはメモリが不足しています。

解説

成功した場合、 UnPublish は、指定された情報を含む WS-Discovery Bye メッセージをローカル サブネットに送信します。

要件

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

関連項目

IWSDiscoveryPublisher