Freigeben über

WSDGenerateFaultEx-Funktion (wsdutil.h)

  • Artikel

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:

Rückgabecode BESCHREIBUNG
S_OK
 Die Methode wurde erfolgreich abgeschlossen.
E_INVALIDARG
 pszCode oder pReasons ist NULL.
E_POINTER
 ppFault ist NULL.

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

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile wsdutil.h (include Wsdapi.h)
Bibliothek Wsdapi.lib
DLL Wsdapi.dll