WSDGenerateFault-Funktion (wsdutil.h)

Generiert einen SOAP-Fehler.

Syntax

HRESULT WSDGenerateFault(
  [in]  LPCWSTR        pszCode,
  [in]  LPCWSTR        pszSubCode,
  [in]  LPCWSTR        pszReason,
  [in]  LPCWSTR        pszDetail,
  [in]  IWSDXMLContext *pContext,
  [out] WSD_SOAP_FAULT **ppFault
);

Parameter

[in] pszCode

Ein SOAP-Fehlercode.

Die Liste der möglichen Fehlercodes folgt. Eine Beschreibung der einzelnen Fehlercodes finden Sie in der SOAP Version 1.2-Spezifikation.

VersionMismatch

MustUnderstand

DataEncodingUnknown

Sender

Receiver

[in] pszSubCode

Eine Fehleruntercodierung.

[in] pszReason

Eine für Menschen lesbare Erklärung des Fehlers.

[in] pszDetail

Enthält anwendungsspezifische Fehlerinformationen, die sich auf den Fehler beziehen.

[in] pContext

Eine IWSDXMLContext-Schnittstelle , die den Kontext darstellt, in dem der Fehler generiert werden soll.

[out] ppFault

Eine WSD_SOAP_FAULT-Struktur , die den generierten Fehler enthält. Wenn die aufrufende Anwendung mit diesen Daten ausgeführt wird, muss ppFault mit einem Aufruf von WSDFreeLinkedMemory freigegeben werden.

Rückgabewert

Mögliche Rückgabewerte sind unter anderem folgendes:

Hinweise

SOAP-Fehler bieten eine Möglichkeit, Fehlerinformationen zu fehlerhaften SOAP-Nachrichten zu kommunizieren. Verschiedene Webdienstprotokolle erweitern Fehler, um kontextbezogene Fehlerinformationen bereitzustellen, und in einigen Fällen, z. B. in WS-Ereigniserstellung, sind Fehler ein erwarteter Teil bestimmter Nachrichtenmuster, da der Client bestimmt, ob das Gerät bestimmte Features unterstützt oder nicht.

Die folgenden Fehleruntercodes werden von WSDAPI nicht implementiert:

• InvalidMessageInformationHeader
• MessageInformationHeaderRequired
• UnsupportedExpirationType
• InvalidMessage
• FilteringNotSupported

Anforderungen