Freigeben über


WsReadMessageStart-Funktion (webservices.h)

Lesen Sie die Kopfzeilen der nächsten Nachricht aus dem Kanal, und bereiten Sie das Lesen der Textelemente vor.

Syntax

HRESULT WsReadMessageStart(
  [in]           WS_CHANNEL             *channel,
  [in]           WS_MESSAGE             *message,
  [in, optional] const WS_ASYNC_CONTEXT *asyncContext,
  [in, optional] WS_ERROR               *error
);

Parameter

[in] channel

Der Kanal, von dem empfangen werden soll.

[in] message

Die Nachricht, in die empfangen werden soll.

[in, optional] asyncContext

Informationen zum asynchronen Aufrufen der Funktion oder NULL beim synchronen Aufruf.

[in, optional] error

Gibt an, wo zusätzliche Fehlerinformationen gespeichert werden sollen, wenn die Funktion fehlschlägt.

Rückgabewert

Diese Funktion kann einen dieser Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
Der Start der Nachricht wurde erfolgreich empfangen.
WS_S_END
Es sind keine weiteren Nachrichten im Kanal verfügbar.
WS_S_ASYNC
Der asynchrone Vorgang steht noch aus.
WS_E_OPERATION_ABORTED
Der Vorgang wurde abgebrochen.
WS_E_INVALID_OPERATION
Der Vorgang ist aufgrund des aktuellen Zustands des Objekts nicht zulässig.
WS_E_ENDPOINT_NOT_FOUND
Der Remoteendpunkt ist nicht vorhanden oder konnte nicht gefunden werden.
WS_E_ENDPOINT_ACCESS_DENIED
Der Zugriff wurde vom Remoteendpunkt verweigert.
WS_E_ENDPOINT_DISCONNECTED
Die Verbindung mit dem Remoteendpunkt wurde beendet.
WS_E_ENDPOINT_FAILURE
Der Remoteendpunkt konnte die Anforderung nicht verarbeiten.
WS_E_ENDPOINT_NOT_AVAILABLE
Der Remoteendpunkt ist an diesem Standort derzeit nicht im Dienst.
WS_E_ENDPOINT_TOO_BUSY
Der Remoteendpunkt kann die Anforderung aufgrund einer Überlastung nicht verarbeiten.
WS_E_ENDPOINT_UNREACHABLE
Der Remoteendpunkt war nicht erreichbar.
WS_E_INVALID_ENDPOINT_URL
Die Endpunktadressen-URL ist ungültig.
WS_E_INVALID_FORMAT
Die Eingabedaten hatten nicht das erwartete Format oder hatten nicht den erwarteten Wert.
WS_E_OPERATION_TIMED_OUT
Der Vorgang wurde innerhalb der zugewiesenen Zeit nicht abgeschlossen.
WS_E_PROXY_ACCESS_DENIED
Der Zugriff wurde vom HTTP-Proxyserver verweigert.
WS_E_PROXY_FAILURE
Der HTTP-Proxyserver konnte die Anforderung nicht verarbeiten.
WS_E_QUOTA_EXCEEDED
Ein Kontingent wurde überschritten.
WS_E_SECURITY_VERIFICATION_FAILURE
Die Sicherheitsüberprüfung für die empfangenen Daten war nicht erfolgreich.
WS_E_SECURITY_SYSTEM_FAILURE
Ein Sicherheitsvorgang ist im Windows Web Services-Framework fehlgeschlagen.
WS_E_SECURITY_TOKEN_EXPIRED
Ein Sicherheitstoken wurde vom Server abgelehnt, weil es abgelaufen ist.
WS_E_PROXY_REQUIRES_BASIC_AUTH
Der HTTP-Proxyserver erfordert das HTTP-Authentifizierungsschema "basic".
WS_E_PROXY_REQUIRES_DIGEST_AUTH
Der HTTP-Proxyserver erfordert das HTTP-Authentifizierungsschema "digest".
WS_E_PROXY_REQUIRES_NEGOTIATE_AUTH
Der HTTP-Proxyserver erfordert das HTTP-Authentifizierungsschema "negotiate".
WS_E_PROXY_REQUIRES_NTLM_AUTH
Der HTTP-Proxyserver erfordert das HTTP-Authentifizierungsschema "NTLM".
WS_E_SERVER_REQUIRES_BASIC_AUTH
Der Remoteendpunkt erfordert das HTTP-Authentifizierungsschema "basic".
WS_E_SERVER_REQUIRES_DIGEST_AUTH
Der Remoteendpunkt erfordert das HTTP-Authentifizierungsschema "digest".
WS_E_SERVER_REQUIRES_NEGOTIATE_AUTH
Der Remoteendpunkt erfordert das HTTP-Authentifizierungsschema "negotiate".
WS_E_SERVER_REQUIRES_NTLM_AUTH
Der Remoteendpunkt erfordert das HTTP-Authentifizierungsschema "NTLM".
CERT_E_EXPIRED
Ein erforderliches Zertifikat liegt nicht innerhalb seines Gültigkeitszeitraums, wenn es mit der aktuellen Systemuhr oder dem Zeitstempel in der signierten Datei überprüft wird.
CERT_E_CN_NO_MATCH
Der Zertifikat-CN-Name stimmt nicht mit dem übergebenen Wert überein.
CERT_E_UNTRUSTEDROOT
Eine Zertifikatkette, die verarbeitet, aber in einem Stammzertifikat beendet wird, dem der Vertrauensanbieter nicht vertraut.
CERT_E_WRONG_USAGE
Das Zertifikat ist für die angeforderte Verwendung nicht zulässig.
CRYPT_E_REVOCATION_OFFLINE
Die Sperrfunktion konnte die Sperrung nicht überprüfen, da der Sperrserver offline war.
E_OUTOFMEMORY
Der Arbeitsspeicher ist nicht mehr vorhanden.
E_INVALIDARG
Mindestens ein Argument ist ungültig.
Andere Fehler
Diese Funktion gibt möglicherweise andere Fehler zurück, die oben nicht aufgeführt sind.

Hinweise

Dadurch wird der Anfang der nächsten Nachricht aus dem Kanal gelesen, einschließlich der Kopfzeilen der Nachricht.

Diese Funktion ähnelt WsReadEnvelopeStart , wird aber mit Kanälen verwendet.

Bei Erfolg werden die Header in der Nachricht gespeichert und können auf zufällige Weise (z. B. mit WsGetHeader) zugegriffen werden.

Die Nachricht muss sich in WS_MESSAGE_STATE_EMPTY Zustand befinden. Nach erfolgreicher Ausführung ist die Nachricht in WS_MESSAGE_STATE_READING Zustand übergewechselt.

Verwenden Sie WsReadBody, um ein Element des Nachrichtentexts zu deserialisieren. Um direkt aus dem XML-Reader der Nachricht zu lesen, rufen Sie zuerst den Reader mithilfe der WS_MESSAGE_PROPERTY_BODY_READER-Eigenschaft ab.

Wenn die Kanaleingabe gestreamt wird (WS_STREAMED_INPUT_TRANSFER_MODE), muss WsFillBody aufgerufen werden, um den nächsten Teil des Texts zu empfangen, bevor er tatsächlich gelesen wird.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile webservices.h
Bibliothek WebServices.lib
DLL WebServices.dll