Fungsi WsGetMessageProperty (webservices.h)

  • Artikel

Mengambil properti objek Pesan tertentu. Properti yang akan diambil diidentifikasi oleh parameter input WS_MESSAGE_PROPERTY_ID .

Sintaks

HRESULT WsGetMessageProperty(
  [in]           WS_MESSAGE             *message,
  [in]           WS_MESSAGE_PROPERTY_ID id,
                 void                   *value,
  [in]           ULONG                  valueSize,
  [in, optional] WS_ERROR               *error
);

Parameter

[in] message

Penunjuk ke objek Pesan yang berisi properti yang diinginkan. Parameter ini harus berupa objek WS_LISTENER yang valid.

[in] id

Ini adalah nilai enumerator WS_MESSAGE_PROPERTY_ID yang mengidentifikasi properti yang diinginkan.

value

Referensi ke lokasi untuk menyimpan nilai properti yang diambil. Penunjuk harus memiliki perataan yang kompatibel dengan jenis properti .

[in] valueSize

Ukuran buffer panjang byte yang dialokasikan oleh pemanggil untuk menyimpan nilai properti yang diambil.

[in, optional] error

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

Nilai kembali

Fungsi ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode Deskripsi
E_INVALIDARG
 Id properti tidak didukung untuk objek ini atau buffer yang ditentukan tidak cukup besar untuk nilai.
E_OUTOFMEMORY
 Aplikasi kehabisan memori.
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