Kanal (Windows-Webdienste)

Kanäle kapseln einen Kommunikationskontext zwischen zwei oder mehr Parteien und werden zum Senden und Empfangen von Nachrichten verwendet.

Verwenden Sie auf dem Client WsCreateChannel , um einen Kanal zu erstellen. Verwenden Sie auf dem Server WsCreateChannelForListener , um einen Kanal zu erstellen, der vom Client mithilfe eines Listeners akzeptiert werden kann.

Wenn Sie einen Kanal erstellen, geben Sie die folgenden Informationen an, die sowohl das lokale Verhalten des Kanals als auch das zu verwendende Übertragungsprotokoll bestimmen.

• Eine WS_CHANNEL_TYPE, die das Nachrichtenaustauschmuster des Kanals identifiziert.
• Ein WS_CHANNEL_BINDING, der das zu verwendende Übertragungsprotokoll identifiziert.
• Ein WS_SECURITY_DESCRIPTION, der die für den Kanal verwendete Sicherheit angibt. Beim Erstellen von Kanälen für die Verwendung auf einem Server wird dies einmal für alle Kanäle angegeben, die für einen bestimmten Listener akzeptiert werden.
• Eine Gruppe WS_CHANNEL_PROPERTYs, die zusätzliche optionale Einstellungen angeben (eine Liste dieser Einstellungen finden Sie in den WS_CHANNEL_PROPERTY_ID-Enumerationen).

Bevor Sie den Kanal verwenden, müssen Sie ihn öffnen, indem Sie die WsOpenChannel-Funktion aufrufen und den Kanal und die Endpunktadresse zusammen mit anderen optionalen Informationen angeben.

Informationen zu den Zustandsübergängen für einen Kanal finden Sie im Thema Kanalstatus .

Weitere Informationen zu Kanälen finden Sie im Thema Übersicht über Kanalebenen .

Die folgenden API-Elemente werden mit Kanälen verwendet.

Rückruf	Beschreibung
WS_ABANDON_MESSAGE_CALLBACK	Behandelt den WsAbandonMessage-Aufruf für einen Kanal mit benutzerdefinierter Kanalbindung.
WS_ABORT_CHANNEL_CALLBACK	Behandelt den WsAbortChannel-Aufruf für einen Kanal mit benutzerdefinierter Kanalbindung.
WS_CLOSE_CHANNEL_CALLBACK	Behandelt den WsCloseChannel-Aufruf für einen Kanal mit benutzerdefinierter Kanalbindung.
WS_CREATE_CHANNEL_CALLBACK	Behandelt den WsCloseChannel-Aufruf für einen Kanal mit benutzerdefinierter Kanalbindung.
WS_CREATE_DECODER_CALLBACK	Behandelt das Erstellen eines Decoders instance.
WS_CREATE_ENCODER_CALLBACK	Behandelt das Erstellen eines Encoders instance.
WS_DECODER_DECODE_CALLBACK	Decodiert eine Nachricht.
WS_DECODER_END_CALLBACK	Decodiert das Ende einer Nachricht.
WS_DECODER_GET_CONTENT_TYPE_CALLBACK	Ruft den Inhaltstyp der Nachricht ab.
WS_DECODER_START_CALLBACK	Startet die Decodierung einer Nachricht.
WS_ENCODER_ENCODE_CALLBACK	Codiert eine Nachricht.
WS_ENCODER_END_CALLBACK	Codiert das Ende einer Nachricht.
WS_ENCODER_GET_CONTENT_TYPE_CALLBACK	Ruft den Inhaltstyp der Nachricht ab.
WS_ENCODER_START_CALLBACK	Startet das Codieren einer Nachricht.
WS_FREE_CHANNEL_CALLBACK	Behandelt den WsFreeChannel-Aufruf für einen Kanal mit benutzerdefinierter Kanalbindung.
WS_FREE_DECODER_CALLBACK	Behandelt das Freigeben eines Decoders instance.
WS_FREE_ENCODER_CALLBACK	Behandelt das Freigeben eines Encoders instance.
WS_GET_CHANNEL_PROPERTY_CALLBACK	Behandelt den WsGetChannelProperty-Aufruf für einen Kanal mit benutzerdefinierter Kanalbindung.
WS_HTTP_REDIRECT_CALLBACK	Wird aufgerufen, wenn eine Nachricht automatisch an einen anderen Dienst umgeleitet werden soll, indem die Funktionalität für die automatische HTTP-Umleitung verwendet wird, wie in RFC2616 beschrieben.
WS_OPEN_CHANNEL_CALLBACK	Behandelt den WsOpenChannel-Aufruf für einen Kanal mit benutzerdefinierter Kanalbindung.
WS_READ_MESSAGE_END_CALLBACK	Behandelt den WsReadMessageEnd-Aufruf für einen Kanal mit benutzerdefinierter Kanalbindung.
WS_READ_MESSAGE_START_CALLBACK	Behandelt den WsReadMessageEnd-Aufruf für einen Kanal mit benutzerdefinierter Kanalbindung.
WS_RESET_CHANNEL_CALLBACK	Behandelt den WsResetChannel-Aufruf für einen Kanal mit benutzerdefinierter Kanalbindung.
WS_SET_CHANNEL_PROPERTY_CALLBACK	Behandelt den WsSetChannelProperty-Aufruf für einen Kanal mit benutzerdefinierter Kanalbindung.
WS_SHUTDOWN_SESSION_CHANNEL_CALLBACK	Behandelt den WsShutdownSessionChannel-Aufruf für einen Kanal mit benutzerdefinierter Kanalbindung.
WS_WRITE_MESSAGE_END_CALLBACK	Behandelt den WsWriteMessageEnd-Aufruf für einen Kanal mit benutzerdefinierter Kanalbindung.
WS_WRITE_MESSAGE_START_CALLBACK	Behandelt den WsWriteMessageStart-Aufruf für einen Kanal mit benutzerdefinierter Kanalbindung.

 

Enumeration	Beschreibung
WS_CHANNEL_BINDING	Gibt den Protokollstapel an, der für den Kanal verwendet werden soll.
WS_CHANNEL_PROPERTY_ID	Identifiziert jede Kanaleigenschaft anhand einer ID.
WS_CHANNEL_STATE	Der Status des Kanals.
WS_CHANNEL_TYPE	Gibt die grundlegenden Merkmale des Kanals an, z. B. ob er sitzungsbehaftet ist und welche Kommunikationsrichtungen unterstützt werden.
WS_ENCODING	Die verschiedenen Codierungen (Nachrichtenformate).
WS_RECEIVE_OPTION	Gibt an, ob beim Empfangen von einem Kanal eine Nachricht erforderlich ist.
WS_TRANSFER_MODE	Gibt an, ob gesendete oder empfangene Nachrichten gestreamt oder gepuffert werden.

 

Funktion	Beschreibung
WsAbandonMessage	Überspringt den Rest einer Nachricht für einen Kanal.
WsAbortChannel	Bricht alle ausstehenden E/A-Vorgänge in einem angegebenen Kanal ab und legt den Kanalstatus auf WS_CHANNEL_STATE_FAULTED fest.
WsCloseChannel	Schließt einen Kanal, wenn er nicht mehr benötigt wird.
WsCreateChannel	Erstellt einen Kanal.
WsCreateChannelForListener	Erstellt einen Kanal für einen Listener.
WsFreeChannel	Gibt die Speicherressourcen frei, die einem Kanal zugeordnet sind.
WsGetChannelProperty	Ruft eine Eigenschaft des Kanals ab, auf den vom Kanalparameter verwiesen wird.
WsOpenChannel	Öffnet einen Kanal zu einem Endpunkt.
WsReadMessageEnd	Liest die schließende Elemente einer Nachricht aus einem Kanal.
WsReadMessageStart	Liest die Kopfzeilen der nächsten Nachricht aus dem Kanal und bereitet das Lesen der Textelemente vor.
WsReceiveMessage	Empfängt eine Nachricht und deserialisiert den Nachrichtentext als Wert.
WsRequestReply	Sendet eine Anforderungsnachricht und empfängt eine korrelierte Antwortnachricht.
WsResetChannel	Setzen Sie einen Kanal zurück, damit er wiederverwendet werden kann.
WsSendMessage	Sendet eine Nachricht in einem Kanal mithilfe der Serialisierung, um das Body-Element zu schreiben.
WsSendReplyMessage	Sendet eine Nachricht, die eine Antwort auf eine empfangene Nachricht ist.
WsSetChannelProperty	Legt eine Eigenschaft eines Kanals fest.
WsSetMessageProperty	Legt eine Eigenschaft einer Nachricht fest.
WsWriteMessageEnd	Schreibt die schließenden Elemente einer Nachricht in den Kanal.
WsWriteMessageStart	Schreiben Sie die Kopfzeilen einer Nachricht in den Kanal, und bereiten Sie das Schreiben der Textelemente vor.

 

Handle	Beschreibung
WS_CHANNEL	Ein undurchsichtiger Typ, der verwendet wird, um auf einen Kanal zu verweisen.

 

Struktur	Beschreibung
WS_CHANNEL_DECODER	Eine Reihe von Rückrufen, die den Inhaltstyp und die codierten Bytes einer empfangenen Nachricht transformieren.
WS_CHANNEL_ENCODER	Eine Reihe von Rückrufen, die den Inhaltstyp und die codierten Bytes einer gesendeten Nachricht transformieren können.
WS_CHANNEL_PROPERTIES	Eine Reihe von WS_CHANNEL_PROPERTY-Strukturen .
WS_CHANNEL_PROPERTY	Eine kanalspezifische Einstellung.
WS_CUSTOM_CHANNEL_CALLBACKS	Eine Reihe von Rückrufen, die die Implementierung eines benutzerdefinierten Kanals bilden.
WS_CUSTOM_HTTP_PROXY	wird verwendet, um den benutzerdefinierten Proxy für den Kanal mithilfe des WS_CHANNEL_PROPERTY_CUSTOM_HTTP_PROXY Werts der WS_CHANNEL_PROPERTY_ID-Enumeration anzugeben.
WS_HTTP_HEADER_MAPPING	Stellt einen einzelnen Header dar, der als Teil von WS_HTTP_MESSAGE_MAPPING zugeordnet wird.
WS_HTTP_MESSAGE_MAPPING	Informationen dazu, wie eine HTTP-Anforderung oder -Antwort in einem Nachrichtenobjekt dargestellt werden soll.
WS_HTTP_REDIRECT_CALLBACK_CONTEXT	Gibt die Rückruffunktion und den Status zum Steuern des Verhaltens der automatischen HTTP-Umleitung an.
WS_MESSAGE_DESCRIPTION	Das Schema für die Eingabe und Ausgabe WS_MESSAGE für eine angegebene Vorgangsbeschreibung.