IWSDiscoveryProviderNotify::Metode SearchFailed (wsddisco.h)
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.
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 |