IWSDiscoveryProvider

WS-Discovery によってネットワーク上でアドバタイズされているサービスを探索(ディスカバリー)するために使用します。

Discovery Provider は WS-Discovery における「クライアント」側のビューを表します。

WSD デバイスを探索する際に検索対象とする IP アドレスファミリ (IPv4、IPv6、またはその両方) を指定します。

このメソッドは次のいずれかの値を返すことがあります。

返される可能性のある値には、以下のものが含まれます (これらに限定されません)。

このメソッドは 1 つのプロバイダーに対して一度だけ呼び出すことができます。また、通知シンクをプロバイダーにアタッチする前に呼び出す必要があります。つまり、SetAddressFamily はプロバイダーに対して Attach を呼び出す前に呼び出す必要があります。

コールバックインターフェイスを discovery provider にアタッチします。

返される可能性のある値には、以下のものが含まれます (これらに限定されません)。

コールバックインターフェイスを discovery provider からデタッチします。

返される可能性のある値には、以下のものが含まれます (これらに限定されません)。

Attach メソッドによってコールバックインターフェイスが discovery provider にアタッチされている場合、プロバイダーインターフェイスオブジェクトへの参照を解放する前に Detach を呼び出す必要があります。

Detach 操作は、関連付けられた IWSDiscoveryProviderNotify オブジェクトへのすべてのコールバックが完了するまでブロックします。

デバイス識別子による WS-Discovery ホストの検索を開始します。

返される可能性のある値には、以下のものが含まれます (これらに限定されません)。

SearchById は、以前に既知であった特定のデバイスを見つけるために WS-Discovery の Resolve を開始します。Resolve のエンドポイントアドレスとして pszId が使用されます。この呼び出しにより、1 つ以上の Add コールバックが発生する場合があります。検索が完了する前に Add コールバックが 1 つでも発行された場合は SearchComplete コールバックが発行され、そうでない場合は SearchFailed コールバックが発行されます。

pszTag は、ユーザーが任意に指定する文字列で、いずれのコールバックにおいても返されるため、呼び出し元はコールバックを元のクエリと対応付けることができます。

このメソッドを呼び出すアプリケーションのトラブルシューティングについては、Troubleshooting WSDAPI Applications を参照してください。

デバイスアドレスによる WS-Discovery ホストの検索を開始します。

返される可能性のある値には、以下のものが含まれます (これらに限定されません)。

SearchByAddress は、既知の URL にあるデバイスを識別するために、HTTP 経由で WS-Discovery の Probe を開始します。Probe は pszAddress で指定されたアドレスに送信されます。この呼び出しにより、1 つ以上の Add コールバックが発生する場合があります。検索が完了する前に Add コールバックが 1 つでも発行された場合は SearchComplete コールバックが発行され、そうでない場合は SearchFailed コールバックが発行されます。検索の開始からこれらの通知のいずれかを受け取るまでの間隔は、最大で 30 秒かかることがあります。

pszTag は、ユーザーが任意に指定する文字列で、いずれのコールバックにおいても返されるため、呼び出し元はコールバックを元のクエリと対応付けることができます。

このメソッドを呼び出すアプリケーションのトラブルシューティングについては、Troubleshooting WSDAPI Applications を参照してください。

デバイスの種類による WS-Discovery ホストの検索を開始します。

返される可能性のある値には、以下のものが含まれます (これらに限定されません)。

SearchByType は、指定した条件に一致する discovery ホストを見つけるために WS-Discovery の Probe を開始します。このメソッドでは、型による照合、スコープによる照合、その両方の組み合わせによる照合、または (スコープも型も指定しない場合は) discovery に対応するすべてのデバイスとの照合が可能です。

pszMatchBy は、pScopesList も指定する場合に限り指定してください。この呼び出しにより、1 つ以上の Add コールバックが発生する場合があります。検索が完了する前に Add コールバックが 1 つでも発行された場合は SearchComplete コールバックが発行され、そうでない場合は SearchFailed コールバックが発行されます。

pszTag は、ユーザーが任意に指定する文字列で、いずれのコールバックにおいても返されるため、呼び出し元はコールバックを元のクエリと対応付けることができます。

このメソッドを呼び出すアプリケーションのトラブルシューティングについては、Troubleshooting WSDAPI Applications を参照してください。

このプロバイダーに関連付けられている XML コンテキストを取得します。

返される可能性のある値には、以下のものが含まれます (これらに限定されません)。

トランザクションの XML 状態に対する任意のコンテキストを返します。サービスレイヤーを使用している場合、これは XML 名前空間および型が登録されたコンテキストになります。