Freigeben über

WSDGenerateFault-Funktion (wsdutil.h)

  • Artikel

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:

Rückgabecode BESCHREIBUNG
S_OK
 Die Methode wurde erfolgreich abgeschlossen.
E_INVALIDARG
 pszCode, pszReason oder pContext 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