Freigeben über


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.