Metode IWSDiscoveryProvider::SearchByType (wsddisco.h)

Artikel
03/04/2024

Menginisialisasi pencarian untuk host WS-Discovery berdasarkan jenis perangkat.

Sintaks

HRESULT SearchByType(
  [in, optional] const WSD_NAME_LIST *pTypesList,
  [in, optional] const WSD_URI_LIST  *pScopesList,
  [in, optional] LPCWSTR             pszMatchBy,
  [in, optional] LPCWSTR             pszTag
);

Parameter

[in, optional] pTypesList

Penunjuk ke struktur WSD_NAME_LIST yang mewakili daftar jenis penyedia penemuan untuk dicari. Mungkin NULL.

[in, optional] pScopesList

Arahkan ke struktur WSD_URI_LIST yang mewakili daftar cakupan penyedia penemuan untuk dicari. Mungkin NULL.

[in, optional] pszMatchBy

Aturan pencocokan yang digunakan untuk cakupan. Mungkin NULL.

[in, optional] pszTag

Tag pengidentifikasi opsional untuk pencarian ini. Mungkin NULL.

Nilai kembali

Kemungkinan nilai yang dikembalikan termasuk, tetapi tidak terbatas pada, berikut ini:

Menampilkan kode	Deskripsi
S_OK	Metode berhasil diselesaikan.
E_INVALIDARG	Panjang karakter pszMatchBy 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

SearchByType memulai WS-Discovery Probe dalam upaya untuk menemukan host penemuan yang cocok dengan kriteria yang disediakan. Metode ini memungkinkan pencocokan berdasarkan jenis, cakupan, beberapa kombinasi keduanya, atau mencocokkan semua perangkat berkemampuan penemuan (ketika tidak ada cakupan atau jenis yang disediakan).

pszMatchBy harus disediakan jika dan hanya jika pScopesList juga disediakan. 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 disalurkan kembali dalam 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

Share via