WSDGenerateFaultEx-Funktion (wsdutil.h)

Generiert einen SOAP-Fehler.

Syntax

HRESULT WSDGenerateFaultEx(
  [in]  WSDXML_NAME               *pCode,
  [in]  WSDXML_NAME               *pSubCode,
  [in]  WSD_LOCALIZED_STRING_LIST *pReasons,
  [in]  LPCWSTR                   pszDetail,
  [out] WSD_SOAP_FAULT            **ppFault
);

Parameter

[in] pCode

Ein SOAP-Fehlercode.

Die Liste der möglichen Fehlercodes folgt. Eine Beschreibung der einzelnen Fehlercodes finden Sie unter

SOAP Version 1.2-Spezifikation.

VersionMismatch

MustUnderstand

DataEncodingUnknown

Sender

Receiver

[in] pSubCode

Eine Fehleruntercodierung.

[in] pReasons

Eine WSD_LOCALIZED_STRING_LIST-Struktur , die eine Liste lokalisierter Ursachencodes enthält.

[in] pszDetail

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

[out] ppFault

Eine WSD_SOAP_FAULT-Struktur , die den generierten Fehler enthält. ppFault muss 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