Fungsi WsRegisterOperationForCancel (webservices.h)

Artikel
03/13/2024

Operasi layanan dapat menggunakan fungsi ini untuk mendaftar pemberitahuan pembatalan. Hanya valid untuk memanggil API ini ketika operasi layanan dijalankan. Perilaku untuk memanggilnya setelah penyelesaian Operasi Layanan tidak didukung.

Meskipun API ini sedang dipanggil dan runtime telah menentukan bahwa pembatalan operasi layanan diperlukan, API ini dapat memanggil panggilan balik selama panggilan ke API ini oleh aplikasi.

Oleh karena itu, pemanggil harus mengasumsikan bahwa runtime dapat memanggil panggilan balik WS_OPERATION_CANCEL_CALLBACK segera setelah WsRegisterOperationForCancel dipanggil.

Sintaks

HRESULT WsRegisterOperationForCancel(
  [in]           const WS_OPERATION_CONTEXT       *context,
  [in]           WS_OPERATION_CANCEL_CALLBACK     cancelCallback,
  [in, optional] WS_OPERATION_FREE_STATE_CALLBACK freestateCallback,
  [in, optional] void                             *userState,
  [in, optional] WS_ERROR                         *error
);

Parameter

[in] context

Konteks tempat nilai properti diperoleh.

[in] cancelCallback

Penunjuk fungsi untuk membatalkan fungsi pemberitahuan.

[in, optional] freestateCallback

Parameter opsional yang menentukan penunjuk fungsi ke panggilan status gratis.

[in, optional] userState

Parameter opsional yang menentukan status spesifik aplikasi yang dapat digunakan untuk mengidentifikasi data panggilan.

[in, optional] error

Menentukan di mana informasi kesalahan tambahan harus disimpan jika fungsi gagal.

Mengembalikan nilai

Jika fungsi ini berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	webservices.h
Pustaka	WebServices.lib
DLL	WebServices.dll

Bagikan melalui