Fungsi WsSendReplyMessage (webservices.h)

  • Artikel

Mengirim pesan yang merupakan balasan ke pesan yang diterima.

Sintaks

HRESULT WsSendReplyMessage(
  [in]           WS_CHANNEL                   *channel,
  [in]           WS_MESSAGE                   *replyMessage,
  [in]           const WS_MESSAGE_DESCRIPTION *replyMessageDescription,
  [in]           WS_WRITE_OPTION              writeOption,
                 const void                   *replyBodyValue,
  [in]           ULONG                        replyBodyValueSize,
  [in]           WS_MESSAGE                   *requestMessage,
  [in, optional] const WS_ASYNC_CONTEXT       *asyncContext,
  [in, optional] WS_ERROR                     *error
);

Parameter

[in] channel

Penunjuk ke objek Saluran untuk mengirim Pesan Balasan. Penunjuk harus mereferensikan objek WS_CHANNEL yang valid.

[in] replyMessage

Penunjuk ke objek Pesan untuk mengirim balasan. Penunjuk harus mereferensikan objek WS_MESSAGE yang valid.

Status objek pesan harus diatur ke WS_MESSAGE_STATE_EMPTY atau WS_MESSAGE_STATE_INITIALIZED.

Catatan Jika pesan yang diinisialisasi disediakan, pesan harus diinisialisasi menggunakan WS_REPLY_MESSAGE atau WS_FAULT_MESSAGE.
 

[in] replyMessageDescription

Penunjuk ke objek WS_MESSAGE_DESCRIPTION . Bidang tindakanWS_MESSAGE_DESCRIPTION digunakan sebagai header tindakan untuk pesan balasan. Bidang ini bisa NULL jika tidak ada tindakan yang diperlukan.

Bidang bodyElementDescriptiondari WS_MESSAGE_DESCRIPTION digunakan untuk menserialisasikan isi pesan balasan. Bidang ini mungkin NULL jika tidak ada elemen isi yang diinginkan. Lihat WsWriteBody untuk informasi tentang bagaimana bodyElementDescription digunakan untuk menserialisasikan nilai.

[in] writeOption

Menentukan apakah elemen isi diperlukan, dan bagaimana nilai dialokasikan.

Lihat WS_WRITE_OPTION untuk informasi selengkapnya.

replyBodyValue

Penunjuk ke nilai yang akan diserialisasikan dalam pesan balasan.

[in] replyBodyValueSize

Ukuran dalam byte dari nilai balasan yang diserialisasikan.

[in] requestMessage

Penunjuk ke objek WS_MESSAGE yang merangkum teks pesan permintaan. Ini digunakan untuk mendapatkan informasi korelasi yang digunakan dalam merumuskan pesan balasan.

Catatan Pesan dapat berada dalam status apa pun kecuali WS_MESSAGE_STATE_EMPTY.
 

[in, optional] asyncContext

Penunjuk ke struktur data WS_ASYNC_CONTEXT dengan informasi tentang memanggil fungsi secara asinkron. Nilai NULL menunjukkan permintaan untuk operasi sinkron.

[in, optional] error

Penunjuk ke objek WS_ERROR tempat informasi tambahan tentang kesalahan harus disimpan jika fungsi gagal.

Mengembalikan nilai

Fungsi ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode Deskripsi
WS_S_ASYNC
 Operasi asinkron masih tertunda.
WS_E_OPERATION_ABORTED
 Operasi dibatalkan.
WS_E_INVALID_OPERATION
 Operasi tidak diperbolehkan karena status objek saat ini.
WS_E_ENDPOINT_DISCONNECTED
 Koneksi dengan titik akhir jarak jauh dihentikan.
WS_E_INVALID_FORMAT
 Data input tidak dalam format yang diharapkan atau tidak memiliki nilai yang diharapkan.
WS_E_OPERATION_TIMED_OUT
 Operasi tidak selesai dalam waktu yang dialokasikan.
WS_E_QUOTA_EXCEEDED
 Kuota terlampaui.
WS_E_SECURITY_VERIFICATION_FAILURE
 Verifikasi keamanan tidak berhasil untuk data yang diterima.
WS_E_SECURITY_SYSTEM_FAILURE
 Operasi keamanan gagal dalam kerangka kerja Windows Web Services.
WS_E_SECURITY_TOKEN_EXPIRED
 Token keamanan ditolak oleh server karena telah kedaluwarsa.
E_OUTOFMEMORY
 Kehabisan memori.
E_INVALIDARG
 Satu atau beberapa argumen tidak valid.
Kesalahan Lain
Fungsi ini dapat mengembalikan kesalahan lain yang tidak tercantum di atas.

Keterangan

Pesan balasan akan menyertakan informasi korelasi yang sesuai dengan WS_ADDRESSING_VERSION. Lihat Gambaran Umum Lapisan Saluran untuk informasi selengkapnya tentang menghubungkan pesan balasan permintaan.

Persyaratan

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