Fungsi WsCall (webservices.h)

Artikel
08/27/2023

Digunakan secara internal oleh proksi layanan untuk memformat argumen yang ditentukan sesuai dengan metadata yang ditentukan dan mengirimkannya dalam pesan. Aplikasi tidak boleh memanggil fungsi ini secara langsung.

Sintaks

HRESULT WsCall(
  [in]           WS_SERVICE_PROXY               *serviceProxy,
  [in]           const WS_OPERATION_DESCRIPTION *operation,
  [in, optional] const void                     **arguments,
  [in]           WS_HEAP                        *heap,
                 const WS_CALL_PROPERTY         *callProperties,
  [in]           const ULONG                    callPropertyCount,
  [in, optional] const WS_ASYNC_CONTEXT         *asyncContext,
  [in, optional] WS_ERROR                       *error
);

Parameter

[in] serviceProxy

Penunjuk ke struktur WS_SERVICE_PROXY yang mewakili proksi layanan.

[in] operation

Arahkan ke struktur WS_OPERATION_DESCRIPTION yang berisi metadata untuk panggilan.

[in, optional] arguments

Array pointer ke argumen individual untuk operasi layanan yang diwakili oleh parameter operasi .

Jumlah elemen harus sesuai dengan jumlah parameter yang ditentukan sebagai bagian dari WS_OPERATION_DESCRIPTION dalam parameter operasi.

[in] heap

Penunjuk ke struktur WS_HEAP yang mewakili timbunan dari mana memori dialokasikan untuk panggilan.

callProperties

Array struktur WS_CALL_PROPERTY yang berisi properti panggilan.

[in] callPropertyCount

Jumlah properti dalam array properti panggilan.

[in, optional] asyncContext

Arahkan ke informasi untuk memanggil fungsi secara asinkron. Teruskan NULL untuk memanggil fungsi secara sinkron.

[in, optional] error

Penunjuk ke struktur WS_ERROR yang menerima informasi kesalahan tambahan jika fungsi gagal.

Mengembalikan nilai

Jika fungsi berhasil, fungsi akan mengembalikan NO_ERROR; jika tidak, kode kesalahan HRESULT akan dikembalikan.

Menampilkan kode	Deskripsi
WS_E_INVALID_OPERATION	Operasi tidak diperbolehkan karena status objek saat ini.
WS_E_QUOTA_EXCEEDED	Kuota terlampaui.
WS_E_OPERATION_ABANDONED	Operasi ditinggalkan.
WS_E_OPERATION_TIMED_OUT	Operasi tidak selesai dalam waktu yang dialokasikan.
E_OUTOFMEMORY	Tidak cukup memori untuk menyelesaikan operasi.
E_INVALIDARG	Satu atau beberapa argumen tidak valid.
WS_S_ASYNC	Operasi asinkron masih tertunda.
Kesalahan Lainnya	Fungsi ini dapat mengembalikan kesalahan lain yang tidak tercantum di atas.

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

Bagikan melalui