Meldung (Windows-Webdienste)
Eine Nachricht ist ein Objekt, das übertragene oder empfangene Daten kapselt. Die Struktur einer Nachricht wird durch SOAP definiert und enthält eine Reihe von Headern und einen Text. Die Header werden immer im Arbeitsspeicher gepuffert, aber der Text wird mit einer Streaming-API gelesen und geschrieben.

Nachrichten verfügen über einen Satz von Eigenschaften, die verwendet werden können, um optionale Einstellungen anzugeben, die das Verhalten einer Nachricht steuern, und um eine Möglichkeit zum Abrufen zusätzlicher Informationen zu empfangenen Nachrichten (z. B. Sicherheitsinformationen) zu bieten. Eine vollständige Liste der Nachrichteneigenschaften finden Sie unter _ _ _ EIGENSCHAFTEN-ID der WS-NACHRICHT.
Eine Nachricht wird an eine bestimmte Endpunktadresse adressiert.
Ein WS _ FAULT ist eine besondere Art von Nachrichteninhalt, mit dem Fehler von einem Remoteendpunkt zurückgegeben werden.
Nachrichten werden codiert, die den XML-Code vor der Übertragung in ein lineares Übertragungsformat transformieren.
Weitere Informationen zu Nachrichten finden Sie im Thema Übersicht über die Kanalebene.
Die folgenden Beispiele veranschaulichen die Verwendung von Nachrichten in WWSAPI.
| Beispiel | Beschreibung |
|---|---|
| CustomHeaderExample | Veranschaulicht die Verwendung benutzerdefinierter Nachrichtenheader. |
| MessageEncodingExample | Veranschaulicht das Codieren und Decodieren einer Nachricht. |
| ForwardMessageExample | Veranschaulicht die Weiterleitung einer Nachricht. |
Die folgenden API-Elemente werden mit Nachrichten verwendet.
| Rückruf | Beschreibung |
|---|---|
| WS _ MESSAGE _ _ DONE-RÜCKRUF | Benachrichtigt den Aufrufer, dass die Verwendung der WS XML READER-Struktur, die für die WsReadEnvevesStart-Funktion bereitgestellt wurde, oder der WS XML WRITER-Struktur abgeschlossen wurde, die für die _ _ _ _ WsWriteEnvevesStart-Funktion bereitgestellt wurde. |
| Enumeration | Beschreibung |
|---|---|
| _WS-ADRESSIERUNGSVERSION _ | Die Version der Spezifikation, die für die Adressierungsheader verwendet wird. |
| _WS-UMSCHLAGVERSION _ | Die Version der Spezifikation, die für die Umschlagstruktur verwendet wird. |
| _WS-HEADERATTRIBUTE _ | Ein Satz von Flags, die die SOAP-Attribute "understand" und "relay" eines Headers darstellen. |
| _WS-HEADERTYP _ | Der Typ des Headers. |
| _WS-NACHRICHTENIN _ INITIALISIERUNG | Gibt an, welche Header WsInitializeMessage der Nachricht hinzufügen soll. |
| _ _ WS-NACHRICHTENEIGENSCHAFTS-ID _ | Die ID jeder Nachrichteneigenschaft. |
| _WS-NACHRICHTENSTATUS _ | Der Status der Nachricht. |
| Funktion | Beschreibung |
|---|---|
| WsAddressMessage | Weist einer Nachricht eine Zieladresse zu. |
| WsCheckMustUnderstandHeaders | Überprüft, ob der Empfänger die angegebenen Header richtig verstanden hat. |
| WsCreateMessage | Erstellt eine Instanz eines WS _ MESSAGE-Objekts. |
| WsCreateMessageForChannel | Erstellt eine Meldung, die für die Verwendung mit einem bestimmten Kanal geeignet ist. |
| WsFillBody | Stellt sicher, dass in einer Nachricht eine ausreichende Anzahl von Bytes zum Lesen verfügbar ist. |
| WsFlushBody | Leert alle akkumulierten Nachrichtentextdaten, die geschrieben wurden. |
| WsFreeMessage | Gibt die einer Nachricht zugeordnete Speicherressource frei. |
| WsGetCustomHeader | Sucht den anwendungsdefinierten Header der Nachricht und deserialisiert ihn. |
| WsGetHeader | Sucht einen bestimmten Standardheader in der Nachricht und deserialisiert ihn. |
| WsGetHeaderAttributes | Füllt einen ULONG-Parameter mit den WS _ HEADER _ ATTRIBUTES aus dem Headerelement auf, auf dem der Reader positioniert ist. |
| WsGetMessageProperty | Ruft eine angegebene Message-Objekteigenschaft ab. |
| WsInitializeMessage | Initialisiert die Header für die Nachricht als Vorbereitung für die Verarbeitung. |
| WsMarkHeaderAsUnderstood | Markiert einen Header als von der Anwendung verstanden. |
| WsReadBody | Deserialisiert einen Wert aus dem XML-Reader der Nachricht. |
| WsReadEnvevesEnd | Liest die schließenden Elemente einer Nachricht. |
| WsReadEnvevesStart | Liest die Header der Nachricht und bereitet das Lesen der Textelemente vor. |
| WsRemoveCustomHeader | Entfernt einen benutzerdefinierten Header aus der Nachricht. |
| WsRemoveHeader | Entfernt das WS _ HEADER _ TYPE-Standardobjekt aus einer Nachricht. |
| WsResetMessage | Legt den Nachrichtenzustand wieder auf WS _ MESSAGE STATE _ EMPTY _ fest. |
| WsSetHeader | Fügt den angegebenen Standardheader in der Nachricht hinzu oder ersetzt ihn. |
| WsWriteBody | Schreibt einen Wert in den Text einer Nachricht. |
| WsWriteEnvevesEnd | Schreibt die schließenden Elemente einer Nachricht. |
| WsWriteEnvevesStart | Schreibt den Anfang der Nachricht einschließlich des aktuellen Sets von Headern der Nachricht und bereitet das Schreiben der Textelemente vor. |
| Handle | Beschreibung |
|---|---|
| _WS-NACHRICHT | Der nicht transparente Typ, der verwendet wird, um auf ein Nachrichtenobjekt zu verweisen. |
| Struktur | Beschreibung |
|---|---|
| _WS-FEHLER | Ein Fehlerwert, der im Text einer Nachricht enthalten ist und auf einen Verarbeitungsfehler hinweist. |
| _WS-FEHLERCODE _ | Stellt einen Fehlercode dar. |
| _WS-FEHLERURSACHE _ | Enthält eine Erläuterung des Fehlers. |
| _WS-NACHRICHTENEIGENSCHAFTEN _ | Gibt einen Satz von WS _ MESSAGE _ PROPERTY-Strukturen an. |
| WS _ _ MESSAGE-EIGENSCHAFT | Gibt eine nachrichtenspezifische Einstellung an. |