WsReadMessageEnd-Funktion (webservices.h)

Artikel
03/13/2024

Lesen Sie die schließende Elemente einer Nachricht aus einem Kanal.

Syntax

HRESULT WsReadMessageEnd(
  [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, für den empfangen werden soll.

[in] message

Die Nachricht, die das Ende von lesen soll.

[in, optional] asyncContext

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

[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
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 waren nicht im erwarteten Format oder hatten nicht den erwarteten Wert.
WS_E_OPERATION_TIMED_OUT	Der Vorgang wurde nicht innerhalb der zugewiesenen Zeit 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 war für die empfangenen Daten nicht erfolgreich.
WS_E_SECURITY_SYSTEM_FAILURE	Fehler bei einem Sicherheitsvorgang im Windows-Webdienstframework.
WS_E_SECURITY_TOKEN_EXPIRED	Ein Sicherheitstoken wurde vom Server abgelehnt, da 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	Für den HTTP-Proxyserver ist das HTTP-Authentifizierungsschema "negotiate" erforderlich.
WS_E_PROXY_REQUIRES_NTLM_AUTH	Der HTTP-Proxyserver erfordert das HTTP-Authentifizierungsschema "NTLM".
WS_E_SERVER_REQUIRES_BASIC_AUTH	Für den Remoteendpunkt ist das HTTP-Authentifizierungsschema "basic" erforderlich.
WS_E_SERVER_REQUIRES_DIGEST_AUTH	Für den Remoteendpunkt ist das HTTP-Authentifizierungsschema "digest" erforderlich.
WS_E_SERVER_REQUIRES_NEGOTIATE_AUTH	Für den Remoteendpunkt ist das HTTP-Authentifizierungsschema "negotiate" erforderlich.
WS_E_SERVER_REQUIRES_NTLM_AUTH	Für den Remoteendpunkt ist das HTTP-Authentifizierungsschema "NTLM" erforderlich.
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, das vom Vertrauensanbieter nicht vertrauenswürdig ist.
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

Die Nachricht muss sich in WS_MESSAGE_STATE_READING Zustand befinden. Bei Erfolg wechselt er in WS_MESSAGE_STATE_DONE Zustand.

Wenn die Streamingeingabe verwendet wird (WS_STREAMED_INPUT_TRANSFER_MODE), stellt der Kanal automatisch sicher, dass Bytes verfügbar sind, bevor das Ende der Nachricht gelesen wird (der schließende Text und die Umschlagtags).

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

Freigeben über