Metode IWSDiscoveryProvider::SearchByAddress (wsddisco.h)

  • Artikel

Menginisialisasi pencarian untuk host WS-Discovery berdasarkan alamat perangkat.

Sintaks

HRESULT SearchByAddress(
  [in]           LPCWSTR pszAddress,
  [in, optional] LPCWSTR pszTag
);

Parameter

[in] pszAddress

Alamat transportasi HTTP perangkat.

[in, optional] pszTag

Tag pengidentifikasi opsional untuk pencarian ini. Mungkin NULL.

Mengembalikan nilai

Kemungkinan nilai pengembalian termasuk, tetapi tidak terbatas pada, berikut ini:

Menampilkan kode Deskripsi
S_OK
 Metode berhasil diselesaikan.
E_INVALIDARG
 pszAddress adalah NULL, panjang karakter pszAddress melebihi WSD_MAX_TEXT_LENGTH (8192), atau panjang karakter pszTag melebihi WSD_MAX_TEXT_LENGTH (8192).
E_ABORT
 Antarmuka panggilan balik belum dilampirkan. Anda harus memanggil Lampirkan sebelum memanggil metode ini.
E_OUTOFMEMORY
 Tidak ada cukup memori untuk melakukan operasi.

Keterangan

SearchByAddress memulai WS-Discovery Probe melalui HTTP dalam upaya untuk mengidentifikasi perangkat di URL yang diketahui. Probe dikirim ke alamat yang ditentukan oleh pszAddress. Panggilan ini dapat mengakibatkan satu atau beberapa panggilan balik. Jika ada panggilan balik Tambahkan yang dikeluarkan sebelum pencarian selesai, panggilan balik SearchComplete akan dikeluarkan; jika tidak, panggilan balik SearchFailed akan dikeluarkan. Interval antara memulai pencarian dan menerima salah satu pemberitahuan ini bisa hingga 30 detik.

pszTag adalah string opsional yang disediakan pengguna yang akan diumpankan kembali di salah satu panggilan balik, memungkinkan pemanggil untuk mengaitkan panggilan balik dengan kueri asli.

Untuk informasi tentang pemecahan masalah aplikasi yang memanggil metode ini, lihat Pemecahan Masalah Aplikasi WSDAPI.

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

IWSDiscoveryProvider