İleti (Windows Web Hizmetleri)
İleti, iletilen veya alınan verileri kapsülleyen bir nesnedir. bir iletinin yapısı SOAP tarafından tanımlanır ve bir üst bilgi kümesi ile bir gövde içerir. Üst bilgiler her zaman bellekte arabelleğe alınsa da gövde bir akış API'siyle okunur ve yazılır.
üst bilgisinin arabelleğe alındığını ve gövdenin akışının yapıldığını gösteren 
İletiler, bir iletinin davranışını denetleyen isteğe bağlı ayarları belirtmek ve alınan iletiler (güvenlik bilgileri gibi) hakkında ek bilgi almak için bir yol sağlamak için kullanılabilecek bir özellik kümesine sahiptir. İleti özelliklerinin tam listesi için bkz. WS_MESSAGE_PROPERTY_ID.
İleti, belirli bir Uç Nokta Adresiadresine giderilir.
WS_FAULT, uzak bir uç noktadan döndürülen hataları temsil etmek için kullanılan özel bir ileti içeriği t işlemidir.
İletiler, iletilmeden önce XML'i doğrusal kablo biçimine dönüştüren kodlamadan geçer.
İletiler hakkında daha fazla bilgi için Kanal Katmanına Genel Bakış konusuna bakın.
Aşağıdaki örneklerde WWSAPI'de iletilerin kullanılması gösterilmektedir.
| Örnek | Açıklama |
|---|---|
| CustomHeaderExample | Özel ileti üst bilgilerini kullanmayı gösterir. |
| MessageEncodingExample | İletiyi kodlamayı ve kodunu çözmeyi gösterir. |
| ForwardMessageExample | İletiyi iletmeyi gösterir. |
İletilerle aşağıdaki API öğeleri kullanılır.
| Geri çağırma | Açıklama |
|---|---|
| WS_MESSAGE_DONE_CALLBACK | Çağırana, iletinin WsReadEnvelopeStart işlevine sağlanan WS_XML_READER yapısını veya WsWriteEnvelopeStart işlevine sağlanan WS_XML_WRITER yapısının kullanımını tamamlandığını bildirir. |
| Sayım | Açıklama |
|---|---|
| WS_ADDRESSING_VERSION | Adresleme üst bilgileri için kullanılan belirtim sürümü. |
| WS_ENVELOPE_VERSION | Zarf yapısı için kullanılan belirtim sürümü. |
| WS_HEADER_ATTRIBUTES | SOAP'yi temsil eden bir dizi bayrak bir üst bilginin özniteliklerini anlamalı ve geçiş yapmalıdır. |
| WS_HEADER_TYPE | Üst bilginin türü. |
| WS_MESSAGE_INITIALIZATION | WsInitializeMessage hangi üst bilgileri iletiye eklemesi gerektiğini belirtir. |
| WS_MESSAGE_PROPERTY_ID | Her ileti özelliğinin kimliği. |
| WS_MESSAGE_STATE | İletinin durumu. |
| Fonksiyon | Açıklama |
|---|---|
| WsAddressMessage | İletiye hedef adres atar. |
| WsCheckMustUnderstandHeaders | Belirtilen üst bilgilerin alıcı tarafından uygun şekilde anlaşıldığını doğrular. |
| WsCreateMessage | WS_MESSAGE nesnesinin bir örneğini oluşturur. |
| WsCreateMessageForChannel | Belirli bir kanalla kullanmak için uygun bir ileti oluşturur. |
| WsFillBody | İletide okuma için yeterli sayıda bayt olmasını sağlar. |
| WsFlushBody | Yazılan tüm birikmiş ileti gövdesi verilerini temizler. |
| WsFreeMessage | İletiyle ilişkili bellek kaynağını serbest bırakır. |
| WsGetCustomHeader | İletinin uygulama tanımlı üst bilgisini bulur ve seri durumdan çıkar. |
| WsGetHeader | İletide belirli bir standart üst bilgi bulur ve seri durumdan çıkar. |
| WsGetHeaderAttributes | Bir ULONG parametresini okuyucunun konumlandırıldığı üst bilgi öğesinden WS_HEADER_ATTRIBUTES ile doldurur. |
| WsGetMessageProperty | Belirtilen message nesnesi özelliğini alır. |
| WsInitializeMessage | İşleme hazırlığında iletinin üst bilgilerini başlatır. |
| WsMarkHeaderAsUnderstood | Bir üst bilgiyi uygulama tarafından anlaşıldığı şekilde işaretler. |
| WsReadBody | İletinin XML Okuyucusu'ndan bir değeri seri durumdan kaldırır. |
| WsReadEnvelopeEnd | İletinin kapanış öğelerini okur. |
| WsReadEnvelopeStart | İletinin üst bilgilerini okur ve gövde öğelerini okumaya hazırlanır. |
| WsRemoveCustomHeader | İletiden özel üst bilgi kaldırır. |
| WsRemoveHeader | Standart WS_HEADER_TYPE nesnesini bir iletiden kaldırır. |
| WsResetMessage | İleti durumunu WS_MESSAGE_STATE_EMPTYolarak ayarlar. |
| WsSetHeader | İletiye belirtilen standart üst bilgiyi ekler veya değiştirir. |
| WsWriteBody | İletinin gövdesine bir değer yazar. |
| WsWriteEnvelopeEnd | İletinin kapanış öğelerini yazar. |
| WsWriteEnvelopeStart | İletinin geçerli üst bilgi kümesini içeren iletinin başlangıcını yazar ve gövde öğelerini yazmaya hazırlanır. |
| Kulp | Açıklama |
|---|---|
| WS_MESSAGE | İleti nesnesine başvurmak için kullanılan opak tür. |
| Yapı | Açıklama |
|---|---|
| WS_FAULT | bir iletinin gövdesinde taşınan ve işleme hatasını gösteren bir hata değeri. |
| WS_FAULT_CODE | Hata kodunu temsil eder. |
| WS_FAULT_REASON | Hatanın açıklamasını içerir. |
| WS_MESSAGE_PROPERTIES | bir WS_MESSAGE_PROPERTY yapıları kümesini belirtir. |
| WS_MESSAGE_PROPERTY | İletiye özgü bir ayar belirtir. |