Metode IUPnPServiceAsync::BeginSubscribeToEvents (upnp.h)

Artikel
03/03/2024

BeginSubscribeToEvents memulai langganan peristiwa dalam mode asinkron dan mendaftarkan panggilan balik aplikasi dengan kerangka kerja UPnP.

Sintaks

HRESULT BeginSubscribeToEvents(
  [in]           IUnknown         *pUnkCallback,
  [in, optional] IUPnPAsyncResult *pAsyncResult,
  [out]          PULONG64         pullRequestID
);

Parameter

[in] pUnkCallback

Menentukan referensi ke objek antarmuka yang berisi panggilan balik untuk mendaftar. Objek ini harus mendukung antarmuka IUPnPServiceCallback atau antarmuka IDispatch .

[in, optional] pAsyncResult

Menentukan referensi ke objek IUPnPAsyncResult . Ketika panggilan BeginSubscribeToEvents selesai, UPnP akan menggunakan metode IUPnPAsyncResult::AsyncOperationComplete untuk memberi tahu titik kontrol.

[out] pullRequestID

Pointer ke nilai ULONG 64-bit yang digunakan untuk mengidentifikasi operasi I/O asinkron. Titik kontrol harus menggunakan handel ini saat mengakhiri atau membatalkan operasi melalui EndSubscribeToEvents atau CancelAsyncOperation.

Mengembalikan nilai

Mengembalikan S_OK pada keberhasilan. Jika tidak, metode mengembalikan kode kesalahan COM yang ditentukan dalam WinError.h atau salah satu nilai berikut:

Menampilkan kode	Deskripsi
E_FAIL	Gagal memulai operasi asinkron.

Catatan Beberapa nilai dapat menunjukkan bahwa kesalahan diterima dari perangkat bersertifikat UPnP. Untuk informasi selengkapnya, lihat Kode Kesalahan Perangkat.

Keterangan

Langganan peristiwa harus diselesaikan sebelum mengkueri variabel status yang di-event dengan BeginQueryStateVariable. Jika ini tidak terjadi, UPNP_E_VARIABLE_VALUE_UNKNOWN dikembalikan, dan langganan peristiwa akan berlangsung secara internal. Akibatnya, panggilan BeginQueryStateVariable berikutnya akan berhasil.

Catatan Untuk layanan tanpa variabel yang ditemui, BeginQueryStateVariable akan selalu berulah seperti yang diharapkan.

Memanggil metode ini beberapa kali akan menghasilkan penambahan beberapa panggilan balik.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 [khusus aplikasi desktop]
Server minimum yang didukung	Windows Server 2012 [hanya aplikasi desktop]
Target Platform	Windows
Header	upnp.h
DLL	Upnp.dll

Lihat juga

IUPnPServiceAsync

IUPnPServiceAsync::CancelAsyncOperation

IUPnPServiceAsync::EndSubscribeToEvents

Bagikan melalui