Metode IWSDiscoveryPublisher::MatchResolveEx (wsddisco.h)
Menentukan apakah pesan Atasi cocok dengan host yang ditentukan dan mengirim pesan WS-Discovery ResolveMatches dengan informasi yang diperluas jika kecocokan dibuat.
Sintaks
HRESULT MatchResolveEx(
[in] const WSD_SOAP_MESSAGE *pResolveMessage,
[in] IWSDMessageParameters *pMessageParameters,
[in] LPCWSTR pszId,
[in] ULONGLONG ullMetadataVersion,
[in] ULONGLONG ullInstanceId,
[in] ULONGLONG ullMessageNumber,
[in, optional] LPCWSTR pszSessionId,
[in, optional] const WSD_NAME_LIST *pTypesList,
[in, optional] const WSD_URI_LIST *pScopesList,
[in, optional] const WSD_URI_LIST *pXAddrsList,
[in, optional] const WSDXML_ELEMENT *pHeaderAny,
[in, optional] const WSDXML_ELEMENT *pReferenceParameterAny,
[in, optional] const WSDXML_ELEMENT *pPolicyAny,
[in, optional] const WSDXML_ELEMENT *pEndpointReferenceAny,
[in, optional] const WSDXML_ELEMENT *pAny
);
Parameter
[in] pResolveMessage
Penunjuk ke struktur WSD_SOAP_MESSAGE yang mewakili pesan Atasi yang diteruskan ke ResolveHandler sink pemberitahuan.
[in] pMessageParameters
Arahkan ke objek IWSDMessageParameters yang mewakili parameter transmisi yang diteruskan ke ResolveHandler sink pemberitahuan.
[in] pszId
Alamat logis atau fisik perangkat, yang digunakan sebagai alamat titik akhir perangkat. Alamat logis adalah dari formulir urn:uuid:{guid}. Alamat fisik dapat menjadi URI yang diawali oleh http atau https, atau hanya URI yang diawali oleh uri. Jika memungkinkan, gunakan alamat logis.
[in] ullMetadataVersion
Versi metadata saat ini.
[in] ullInstanceId
Pengidentifikasi untuk instans perangkat saat ini yang diterbitkan. Pengidentifikasi ini harus dinaikkan setiap kali layanan dimulai ulang. Untuk informasi selengkapnya tentang pengidentifikasi instans, lihat Lampiran I spesifikasi WS-Discovery.
[in] ullMessageNumber
Penghitung dalam cakupan pengidentifikasi instans untuk pesan saat ini. Nomor pesan harus bertahap untuk setiap pesan.
[in, optional] pszSessionId
Pengidentifikasi unik dalam cakupan pengidentifikasi instans untuk sesi saat ini. Parameter ini sesuai dengan pengidentifikasi urutan di blok AppSequence dalam pesan Probe. Untuk informasi selengkapnya tentang pengidentifikasi urutan, lihat Lampiran I spesifikasi WS-Discovery.
Parameter ini mungkin NULL.
[in, optional] pTypesList
Penunjuk ke struktur WSD_NAME_LIST yang mewakili daftar jenis yang didukung oleh host penerbitan. Mungkin NULL. Jika pTypesList ditentukan, MatchResolveEx akan menggunakan logika pencocokan WS-Discovery untuk memverifikasi bahwa jenis cocok dengan yang ditentukan di pResolveMessage.
[in, optional] pScopesList
Arahkan ke struktur WSD_URI_LIST yang mewakili daftar cakupan pencocokan yang didukung oleh host penerbitan. Daftar berisi nilai hash dalam formulir string. Mungkin NULL. Jika pScopesList ditentukan, MatchResolveEx akan menggunakan logika WS-Discovery cocok untuk memverifikasi bahwa cakupan cocok dengan yang ditentukan dalam pResolveMessage.
[in, optional] pXAddrsList
Penunjuk ke struktur WSD_URI_LIST yang mewakili daftar alamat transportasi yang didukung oleh host penerbitan. Setiap string alamat transportasi berisi alamat dan nomor port yang dapat digunakan untuk koneksi oleh host jarak jauh. pXAddrsList dan pXAddrsList-Element> mungkin bukan NULL.
[in, optional] pHeaderAny
Penunjuk ke struktur WSDXML_ELEMENT yang berisi elemen XML yang akan disisipkan di bagian "ANY" header.
[in, optional] pReferenceParameterAny
Penunjuk ke struktur WSDXML_ELEMENT yang berisi elemen XML yang akan disisipkan di bagian "ANY" dari properti parameter referensi.
[in, optional] pPolicyAny
Tidak digunakan.
[in, optional] pEndpointReferenceAny
Penunjuk ke struktur WSDXML_ELEMENT yang berisi elemen XML yang akan disisipkan di bagian "ANY" dari titik akhir.
[in, optional] pAny
Penunjuk ke struktur WSDXML_ELEMENT yang berisi elemen XML yang akan disisipkan di bagian "ANY" dari isi pesan.
Mengembalikan nilai
Kemungkinan nilai yang dikembalikan termasuk, tetapi tidak terbatas pada, berikut ini:
| Menampilkan kode | Deskripsi |
|---|---|
|
Metode berhasil diselesaikan. |
|
Satu atau beberapa kondisi berikut ini benar:
|
|
Penerbit belum dimulai. Melampirkan sink pemberitahuan memulai penerbit. Untuk melampirkan sink, panggil RegisterNotificationSink. |
|
Tidak cukup memori untuk menyelesaikan operasi. |
Keterangan
MatchResolveEx seharusnya hanya ketika penerbit penemuan telah mengeluarkan panggilan balik ResolveHandler . pResolveMessage dan pMessageParameters diteruskan langsung dari panggilan balik ke MatchResolveEx. ResolveHandler juga meneruskan informasi yang diperlukan oleh penerbit untuk menentukan apakah pesan Resolve yang disediakan cocok dan, jika demikian, untuk mengeluarkan respons ResolveMatches jika sesuai.
MatchResolveEx mengirim pesan ResolveMatches pada semua adaptor terikat dan secara otomatis mengeluarkan transmisi ulang pesan saat diperlukan oleh WS-Discovery.
Parameter yang mengacu pada struktur WSDXML_ELEMENT dapat digunakan untuk memperluas konten pesan ResolveMatches yang dikirim dengan informasi kustom.
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 |