IWSDiscoveryProvider::SearchByAddress メソッド (wsddisco.h)
デバイス アドレスによる WS-Discovery ホストの 検索を初期化します。
構文
HRESULT SearchByAddress(
[in] LPCWSTR pszAddress,
[in, optional] LPCWSTR pszTag
);
パラメーター
[in] pszAddress
デバイスの HTTP トランスポート アドレス。
[in, optional] pszTag
この検索の省略可能な識別子タグ。 NULL を指定できます。
戻り値
可能な戻り値には、次のものが含まれますが、これらに限定されません。
リターン コード | 説明 |
---|---|
|
メソッドは正常に完了しました。 |
|
pszAddress が NULL、 pszAddress の文字数がWSD_MAX_TEXT_LENGTH (8192) を超えているか、 pszTag の文字数が WSD_MAX_TEXT_LENGTH (8192) を超えています。 |
|
コールバック インターフェイスがアタッチされていません。 このメソッドを呼び出す前に Attach を呼び出す必要があります。 |
|
操作を実行するのに十分なメモリがありません。 |
注釈
SearchByAddress は、既知の URL でデバイスを識別しようとして、HTTP 経由の WS-Discovery プローブ を開始します。 Probe は pszAddress で指定されたアドレスに送信されます。 この呼び出しにより、1 つ以上の Add コールバックが発生する可能性があります。 検索が完了する前に Add コールバックが発行されると、 SearchComplete コールバックが発行されます。それ以外の場合は、 SearchFailed コールバックが 発行されます。 検索を開始してから、これらの通知のいずれかを受信するまでの間隔は、最大 30 秒です。
pszTag は、いずれかのコールバックでフィードバックされる省略可能なユーザー指定の文字列であり、呼び出し元はコールバックを元のクエリに関連付けることができます。
このメソッドを呼び出すアプリケーションのトラブルシューティングについては、「 WSDAPI アプリケーションのトラブルシューティング」を参照してください。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | wsddisco.h (Wsdapi.h を含む) |
[DLL] | Wsdapi.dll |