Üzenet (Windows Web Services)
Az üzenet egy olyan objektum, amely a továbbított vagy fogadott adatokat foglalja magában. Az üzenet struktúráját a SOAP határozza meg, és fejléceket és törzseket tartalmaz. A fejlécek mindig pufferelve vannak a memóriában, de a törzs olvasása és írása streamELŐ API-val történik.
Az üzenetek olyan tulajdonságokkal rendelkeznek, amelyek segítségével megadható az üzenetek viselkedését szabályozó választható beállítások, valamint a fogadott üzenetekre vonatkozó további információk (például biztonsági információk) lekérésének módja. Az üzenettulajdonságok teljes listáját a WS_MESSAGE_PROPERTY_ID találja.
Az üzenet címzettje egy adott végpontcím.
A WS_FAULT egy speciális üzenettartalom, amely egy távoli végpontról visszaadott hibák megjelenítésére szolgál.
Az üzenetek kódoláson esnek át, amelyek az XML-t lineáris drótformátummá alakítják át az átvitel előtt.
További információ az üzenetekről: Csatornaréteg áttekintése témakör.
Az alábbi példák az üzenetek WWSAPI-ban való használatát szemléltetik.
| Példa | Leírás |
|---|---|
| CustomHeaderExample | Egyéni üzenetfejlécek használatát szemlélteti. |
| MessageEncodingExample | Egy üzenet kódolását és dekódolását szemlélteti. |
| ForwardMessageExample | Egy üzenet továbbítását szemlélteti. |
A rendszer az alábbi API-elemeket használja az üzenetekhez.
| Visszahívási | Leírás |
|---|---|
| WS_MESSAGE_DONE_CALLBACK | Értesíti a hívót, hogy az üzenet befejezte a WsReadEnvelopeStart függvényhez kapott WS_XML_READER struktúra vagy a WsWriteEnvelopeStart függvényhez megadott WS_XML_WRITER szerkezet használatát. |
| Felsorolás | Leírás |
|---|---|
| WS_ADDRESSING_VERSION | A címzési fejlécekhez használt specifikáció verziója. |
| WS_ENVELOPE_VERSION | A borítékszerkezethez használt specifikáció verziója. |
| WS_HEADER_ATTRIBUTES | A SOAP mustUnderstand és relay attribútumait jelképező jelzők készlete egy fejlécben. |
| WS_HEADER_TYPE | A fejléc típusa. |
| WS_MESSAGE_INITIALIZATION | Megadja, hogy a WsInitializeMessage mely fejléceket vegye fel az üzenetbe. |
| WS_MESSAGE_PROPERTY_ID | Az egyes üzenettulajdonságok azonosítója. |
| WS_MESSAGE_STATE | Az üzenet állapota. |
| Funkció | Leírás |
|---|---|
| WsAddressMessage | Célcím hozzárendelése egy üzenethez. |
| WsCheckMustUnderstandHeaders | Ellenőrzi, hogy a fogadó megfelelően értelmezte-e a megadott fejléceket. |
| WsCreateMessage | Létrehoz egy WS_MESSAGE objektumpéldányt. |
| WsCreateMessageForChannel | Egy adott csatornához megfelelő üzenetet hoz létre. |
| WsFillBody | Biztosítja, hogy elegendő számú bájt legyen elérhető egy üzenetben az olvasáshoz. |
| WsFlushBody | Kiüríti az összes felgyülemlett üzenettörzs-adatot, amelyet megírtak. |
| WsFreeMessage | Felszabadítja az üzenethez társított memóriaerőforrást. |
| WsGetCustomHeader | Megkeresi az üzenet alkalmazás által definiált fejlécét, és deszerializálja azt. |
| WsGetHeader | Megkeres egy adott szabványos fejlécet az üzenetben, és deszerializálja azt. |
| WsGetHeaderAttributes | Feltölt egy ULONG-paramétert a WS_HEADER_ATTRIBUTES abból a fejlécelemből, amelyen az olvasó elhelyezve van. |
| WsGetMessageProperty | Lekéri a megadott Üzenetobjektum tulajdonságot. |
| WsInitializeMessage | Inicializálja az üzenet fejléceit a feldolgozás előkészítése során. |
| WsMarkHeaderAsUnderstood | Az alkalmazás által értelmezett fejlécet jelöli meg. |
| WsReadBody | Deszerializál egy értéket az üzenet XML-olvasójából. |
| WsReadEnvelopeEnd | Felolvassa az üzenet záró elemeit. |
| WsReadEnvelopeStart | Beolvassa az üzenet fejléceit, és előkészíti a törzselemek olvasását. |
| WsRemoveCustomHeader | Eltávolít egy egyéni fejlécet az üzenetből. |
| WsRemoveHeader | Eltávolítja a szabványos WS_HEADER_TYPE objektumot egy üzenetből. |
| WsResetMessage | Az Üzenet állapot visszaállítása WS_MESSAGE_STATE_EMPTYértékre. |
| WsSetHeader | Hozzáadja vagy lecseréli a megadott szabványos fejlécet az üzenetben. |
| WsWriteBody | Értéket ír egy üzenet törzsébe. |
| WsWriteEnvelopeEnd | Az üzenet záró elemeinek megírása. |
| WsWriteEnvelopeStart | Megírja az üzenet elejét, beleértve az üzenet aktuális fejléckészletét, és előkészíti a törzselemek megírását. |
| Fogantyú | Leírás |
|---|---|
| WS_MESSAGE | Az üzenetobjektumra való hivatkozáshoz használt átlátszatlan típus. |
| Szerkezet | Leírás |
|---|---|
| WS_FAULT | Egy üzenet törzsében található hibaérték, amely feldolgozási hibát jelez. |
| WS_FAULT_CODE | Hibakódot jelöl. |
| WS_FAULT_REASON | A hiba magyarázatát tartalmazza. |
| WS_MESSAGE_PROPERTIES | WS_MESSAGE_PROPERTY struktúrák halmazát adja meg. |
| WS_MESSAGE_PROPERTY | Egy üzenetspecifikus beállítást ad meg. |