Metode IWSDiscoveryProvider::SearchByAddress (wsddisco.h)

Artikel
03/04/2024

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

Bagikan melalui