Meddelande (Windows Web Services)
Ett meddelande är ett objekt som kapslar in data som överförs eller tas emot. Strukturen för ett meddelande definieras av SOAP och innehåller en uppsättning rubriker och en brödtext. Rubrikerna buffrar alltid i minnet, men brödtexten läss och skrivs med ett API för direktuppspelning.
Meddelanden har en uppsättning egenskaper som kan användas för att ange valfria inställningar som styr beteendet för ett meddelande och för att ge ett sätt att hämta ytterligare information om mottagna meddelanden (till exempel säkerhetsinformation). En fullständig lista över meddelandeegenskaper finns i WS_MESSAGE_PROPERTY_ID.
Ett meddelande adresseras till en specifik slutpunktsadress.
En WS_FAULT är en särskild typ av meddelandeinnehåll som används för att representera fel som returneras från en fjärrslutpunkt.
Meddelanden genomgår kodning som omvandlar XML till ett linjärt trådformat innan de överförs.
Mer information om meddelanden finns i avsnittet Channel Layer Overview .
Följande exempel illustrerar hur du använder meddelanden i WWSAPI.
| Exempel | Beskrivning |
|---|---|
| CustomHeaderExample | Visar hur du använder anpassade meddelandehuvuden. |
| MessageEncodingExample | Illustrerar kodning och avkodning av ett meddelande. |
| ForwardMessageExample | Visar vidarebefordran av ett meddelande. |
Följande API-element används med meddelanden.
| Motringning | Beskrivning |
|---|---|
| WS_MESSAGE_DONE_CALLBACK | Meddelar anroparen att meddelandet har slutfört sin användning av antingen den WS_XML_READER struktur som har angetts för WsReadEnvelopeStart-funktionen eller av den WS_XML_WRITER struktur som har angetts till funktionen WsWriteEnvelopeStart. |
| Uppräkning | Beskrivning |
|---|---|
| WS_ADDRESSING_VERSION | Den version av specifikationen som används för adresshuvudena. |
| WS_ENVELOPE_VERSION | Den version av specifikationen som används för kuvertstrukturen. |
| WS_HEADER_ATTRIBUTES | En uppsättning flaggor som representerar SOAP måsteUnderstående och reläattribut för en rubrik. |
| WS_HEADER_TYPE | Typ av rubrik. |
| WS_MESSAGE_INITIALIZATION | Anger vilka rubriker WsInitializeMessage ska lägga till i meddelandet. |
| WS_MESSAGE_PROPERTY_ID | ID för varje meddelandeegenskap. |
| WS_MESSAGE_STATE | Meddelandets tillstånd. |
| Funktion | Beskrivning |
|---|---|
| WsAddressMessage | Tilldelar en måladress till ett meddelande. |
| WsCheckMustUnderstandHeaders | Verifierar att angivna huvuden förstods korrekt av mottagaren. |
| WsCreateMessage | Skapar en instans av ett WS_MESSAGE objekt. |
| WsCreateMessageForChannel | Skapar ett meddelande som är lämpligt för användning med en specifik kanal. |
| WsFillBody | Säkerställer att det finns tillräckligt många byte tillgängliga i ett meddelande för läsning. |
| WsFlushBody | Rensar alla ackumulerade meddelandetextdata som har skrivits. |
| WsFreeMessage | Frigör minnesresursen som är associerad med ett meddelande. |
| WsGetCustomHeader | Söker efter det programdefinierade huvudet i meddelandet och deserialiserar det. |
| WsGetHeader | Hittar en viss standardrubrik i meddelandet och deserialiserar det. |
| WsGetHeaderAttributes | Fyller i en ULONG-parameter med WS_HEADER_ATTRIBUTES från huvudelementet där läsaren är placerad. |
| WsGetMessageProperty | Hämtar en angiven egenskap för meddelandeobjekt. |
| WsInitializeMessage | Initierar sidhuvudena för meddelandet som förberedelse för bearbetning. |
| WsMarkHeaderAsUnderförstått | Markerar en rubrik som programmet förstår. |
| WsReadBody | Deserialiserar ett värde från XML-läsaren för meddelandet. |
| WsReadEnvelopeEnd | Läser de avslutande elementen i ett meddelande. |
| WsReadEnvelopeStart | Läser sidhuvudena i meddelandet och förbereder sig för att läsa brödtextelementen. |
| WsRemoveCustomHeader | Tar bort en anpassad rubrik från meddelandet. |
| WsRemoveHeader | Tar bort standardobjektet WS_HEADER_TYPE från ett meddelande. |
| WsResetMessage | Anger meddelandetillståndet till WS_MESSAGE_STATE_EMPTY. |
| WsSetHeader | Lägger till eller ersätter den angivna standardrubriken i meddelandet. |
| WsWriteBody | Skriver ett värde i brödtexten i ett meddelande. |
| WsWriteEnvelopeEnd | Skriver de avslutande elementen i ett meddelande. |
| WsWriteEnvelopeStart | Skriver början av meddelandet, inklusive den aktuella uppsättningen rubriker i meddelandet och förbereder sig för att skriva brödtextelementen. |
| Handtag | Beskrivning |
|---|---|
| WS_MESSAGE | Den ogenomskinliga typ som används för att referera till ett meddelandeobjekt. |
| Struktur | Beskrivning |
|---|---|
| WS_FAULT | Ett felvärde i brödtexten i ett meddelande som anger ett bearbetningsfel. |
| WS_FAULT_CODE | Representerar en felkod. |
| WS_FAULT_REASON | Innehåller en förklaring av felet. |
| WS_MESSAGE_PROPERTIES | Anger en uppsättning WS_MESSAGE_PROPERTY strukturer. |
| WS_MESSAGE_PROPERTY | Anger en meddelandespecifik inställning. |