Share via

IWSDiscoveryProviderNotify::Metode SearchFailed (wsddisco.h)

  • Artikel

Dipanggil untuk menunjukkan bahwa pencarian yang dimulai pengguna telah gagal.

Sintaks

HRESULT SearchFailed(
  [in]           HRESULT hr,
  [in, optional] LPCWSTR pszTag
);

Parameter

[in] hr

Penyebab kegagalan pencarian yang memulai panggilan balik ini. Nilai S_FALSE menunjukkan pencarian selesai tanpa mengeluarkan panggilan balik Tambahkan apa pun.

[in, optional] pszTag

Tag pengidentifikasi opsional untuk pencarian ini. Mungkin NULL.

Nilai kembali

Nilai yang dikembalikan tidak bermakna. Pelaksana harus mengembalikan S_OK.

Keterangan

SearchComplete dipanggil jika ada respons yang berhasil diterima.

SearchFailed dipanggil jika kueri yang dimulai pengguna tidak menghasilkan respons. Dalam hal ini, nilai parameter jam akan S_FALSE. SearchFailed secara opsional dapat dipanggil jika kesalahan terjadi dalam upaya transmisi kueri, karena transmisi kueri belum tentu sinkron. pszTag akan cocok dengan tag yang disediakan pengguna dari kueri, dan harus digunakan untuk mengidentifikasi kueri mana yang gagal.

Interval antara memulai pencarian dengan SearchByType atau SearchById dan menerima pemberitahuan SearchFailed adalah maksimum 10 detik, berdasarkan MATCH_TIMEOUT dari WS-Discovery dan diubah oleh Lampiran DPWS I. Interval antara memulai pencarian dengan SearchByAddress dan tanda terima pemberitahuan SearchFailed biasanya 21 detik, tetapi bisa maksimal 150 detik.

Catatan Beberapa panggilan simultan dapat dilakukan ke SearchFailed oleh penyedia, jadi sangat penting bahwa data bersama disinkronkan dalam panggilan balik ini.
 

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 [hanya aplikasi desktop]
Target Platform Windows
Header wsddisco.h (termasuk Wsdapi.h)
DLL Wsdapi.dll

Lihat juga

IWSDiscoveryProviderNotify