WS_READ_MESSAGE_START_CALLBACK Rückruffunktion (webservices.h)

Artikel
08/27/2023

Behandelt den WsReadMessageStart-Aufruf für einen WS_CUSTOM_CHANNEL_BINDING.

Syntax

WS_READ_MESSAGE_START_CALLBACK WsReadMessageStartCallback;

HRESULT WsReadMessageStartCallback(
  [in]           void *channelInstance,
  [in]           WS_MESSAGE *message,
  [in, optional] const WS_ASYNC_CONTEXT *asyncContext,
  [in, optional] WS_ERROR *error
)
{...}

Parameter

[in] channelInstance

Der Zeiger auf den für diesen Kanal spezifischen Zustand instance, wie er vom WS_CREATE_CHANNEL_CALLBACK erstellt wird.

[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

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

Informationen zum Vertrag dieser API finden Sie unter WsReadMessageStart .

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	webservices.h

Freigeben über