struktur WS_HTTP_MESSAGE_MAPPING (webservices.h)

Menentukan informasi tentang bagaimana permintaan atau respons HTTP harus diwakili dalam objek pesan.

Sintaks

typedef struct _WS_HTTP_MESSAGE_MAPPING {
  ULONG                  requestMappingOptions;
  ULONG                  responseMappingOptions;
  WS_HTTP_HEADER_MAPPING **requestHeaderMappings;
  ULONG                  requestHeaderMappingCount;
  WS_HTTP_HEADER_MAPPING **responseHeaderMappings;
  ULONG                  responseHeaderMappingCount;
} WS_HTTP_MESSAGE_MAPPING;

Anggota

requestMappingOptions

Opsi yang mengontrol bagaimana informasi dalam permintaan HTTP dipetakan ke objek pesan.

responseMappingOptions

Opsi yang mengontrol bagaimana informasi dalam respons HTTP dipetakan ke objek pesan.

requestHeaderMappings

Array pointer ke pemetaan yang menjelaskan header HTTP mana yang dipetakan ke/dari header di objek pesan untuk permintaan HTTP. Penunjuk dalam array mungkin bukan NULL.

requestHeaderMappingCount

Jumlah item dalam array requestHeaderMappings.

responseHeaderMappings

Array pointer ke pemetaan yang menjelaskan header HTTP mana yang dipetakan ke/dari header di objek pesan untuk respons HTTP. Penunjuk dalam array mungkin bukan NULL.

responseHeaderMappingCount

Jumlah item dalam array responseHeaderMappings.

Keterangan

Pesan mungkin berisi informasi khusus transportasi tambahan yang bukan bagian dari amplop pesan. Informasi khusus transportasi ini dapat diekspos secara terprogram sebagai header objek pesan.
Header ini disebut sebagai header yang dipetakan.

Setiap header yang dipetakan disimpan sebagai elemen header reguler di header pesan (lihat WS_MESSAGE_PROPERTY_HEADER_BUFFER). Namespace XML kosong ("") digunakan untuk header yang dipetakan.

Struktur ini menentukan bagaimana pemetaan terjadi antara permintaan atau respons HTTP dan header objek pesan yang dipetakan. Struktur dapat ditentukan menggunakan properti WS_CHANNEL_PROPERTY_HTTP_MESSAGE_MAPPING .

Diagram berikut menunjukkan bagaimana header HTTP dipetakan ke header pesan.

Ketika pesan diterima, saluran HTTP akan secara otomatis menyalin header HTTP yang ditentukan dari permintaan atau respons ke header objek pesan. Aplikasi kemudian dapat menggunakan WsGetMappedHeader untuk mendapatkan nilai header yang dipetakan.

Sebelum pesan dikirim, aplikasi dapat menambahkan header yang dipetakan ke objek pesan menggunakan WsAddMappedHeader. Ketika pesan dikirim, saluran HTTP akan secara otomatis menghapus header yang ditentukan dari header objek pesan (sehingga tidak muncul di dalam amplop), dan menambahkannya sebagai permintaan HTTP atau header respons.

Saluran HTTP hanya akan melakukan pemetaan ini untuk header HTTP yang telah ditentukan dalam bidang requestHeaderMappings atau responseHeaderMappings. WS_HTTP_HEADER_MAPPING digunakan untuk menentukan setiap header, dan menyertakan instruksi tentang bagaimana header pesan diubah menjadi/dari header HTTP.

Informasi lain dalam permintaan atau respons HTTP yang tidak sesuai dengan header HTTP dapat dipetakan ke header objek pesan dengan mengatur requestMappingOptions atau responseMappingOptions. Nilai yang dipetakan ini kemudian dapat diekstrak menggunakan WsGetMappedHeader.
Lihat WS_HTTP_REQUEST_MAPPING_OPTIONS atau WS_HTTP_RESPONSE_MAPPING_OPTIONS untuk informasi tentang informasi apa yang dapat dipetakan ke header pesan.

Persyaratan

Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Header	webservices.h