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.

Diagramm, das eine Meldung zeigt, bei der der Header gepuffert und der Text gestreamt wird.

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.