Fungsi WsCreateServiceProxy (webservices.h)

Artikel
08/27/2023

Membuat proksi layanan dengan properti yang ditentukan.

Sintaks

HRESULT WsCreateServiceProxy(
  [in]           const WS_CHANNEL_TYPE         channelType,
  [in]           const WS_CHANNEL_BINDING      channelBinding,
  [in, optional] const WS_SECURITY_DESCRIPTION *securityDescription,
                 const WS_PROXY_PROPERTY       *properties,
  [in]           const ULONG                   propertyCount,
                 const WS_CHANNEL_PROPERTY     *channelProperties,
  [in]           const ULONG                   channelPropertyCount,
                 WS_SERVICE_PROXY              **serviceProxy,
  [in, optional] WS_ERROR                      *error
);

Parameter

[in] channelType

Nilai enumerasi WS_CHANNEL_TYPE yang mewakili jenis saluran untuk proksi layanan.

[in] channelBinding

Nilai enumerasi WS_CHANNEL_BINDING yang mewakili pengikatan saluran.

[in, optional] securityDescription

Struktur WS_SECURITY_DESCRIPTION yang mewakili deskripsi keamanan.

properties

Array struktur WS_PROXY_PROPERTY yang berisi properti opsional untuk proksi layanan.

Nilai parameter ini mungkin NULL, dalam hal ini, parameter propertyCount harus 0 (nol).

[in] propertyCount

Jumlah properti dalam array properti .

channelProperties

Array struktur WS_CHANNEL_PROPERTY yang berisi properti saluran opsional. Nilai parameter ini mungkin NULL, dalam hal ini, parameter channelPropertyCount harus 0 (nol).

Catatan Berhati-hatilah dengan memodifikasi nilai default untuk properti ini.

[in] channelPropertyCount

Jumlah properti dalam array channelProperties .

serviceProxy

Jika berhasil, pointer yang menerima alamat struktur WS_SERVICE_PROXY mewakili proksi layanan baru.

Ketika Anda tidak lagi membutuhkan struktur ini, Anda harus membebaskannya dengan memanggil WsFreeServiceProxy.

[in, optional] error

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

Nilai kembali

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

Menampilkan kode	Deskripsi
E_INVALIDARG	Satu atau beberapa argumen tidak valid.
E_OUTOFMEMORY	Tidak cukup memori untuk menyelesaikan operasi.
Kesalahan Lain	Fungsi ini dapat mengembalikan kesalahan lain yang tidak tercantum di atas.

Persyaratan


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