Bagikan melalui

Metode IWSDiscoveryProvider::SearchById (wsddisco.h)

  • Artikel

Menginisialisasi pencarian untuk host WS-Discovery berdasarkan pengidentifikasi perangkat.

Sintaks

HRESULT SearchById(
  [in]           LPCWSTR pszId,
  [in, optional] LPCWSTR pszTag
);

Parameter

[in] pszId

Pengidentifikasi perangkat dari penyedia penemuan yang diinginkan.

[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
 pszId adalah NULL, panjang karakter pszId 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

SearchById memulai WS-Discovery Resolve dalam upaya untuk menemukan perangkat tertentu yang diketahui sebelumnya. pszId digunakan sebagai alamat titik akhir di Atasi. 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.

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

   
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