WSDGenerateFault, fonction (wsdutil.h)

Article
08/28/2023

Génère une erreur SOAP.

Syntaxe

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

Paramètres

[in] pszCode

Code d’erreur SOAP.

La liste des codes d’erreur possibles est la suivante. Pour obtenir une description de chaque code d’erreur, consultez la spécification SOAP version 1.2.

VersionMismatch

MustUnderstand

DataEncodingUnknown

Expéditeur

Destinataire

[in] pszSubCode

Sous-code d’erreur.

[in] pszReason

Explication lisible de la faute.

[in] pszDetail

Contient des informations d’erreur spécifiques à l’application relatives à l’erreur.

[in] pContext

Interface IWSDXMLContext qui représente le contexte dans lequel générer l’erreur.

[out] ppFault

Structure WSD_SOAP_FAULT qui contient l’erreur générée. Lorsque l’application appelante est terminée avec ces données, ppFault doit être libéré avec un appel à WSDFreeLinkedMemory.

Valeur retournée

Les valeurs de retour possibles incluent, sans s’y limiter, les éléments suivants :

Code de retour	Description
S_OK	La méthode s’est terminée avec succès.
E_INVALIDARG	pszCode, pszReason ou pContext a la valeur NULL.
E_POINTER	ppFault a la valeur NULL.

Remarques

Les erreurs SOAP fournissent un moyen de communiquer des informations d’erreur sur les messages SOAP ayant échoué. Différents protocoles de services web étendent les erreurs pour fournir des informations contextuelles sur les erreurs et, dans certains cas, comme dans WS-Eventing, les erreurs sont une partie attendue de modèles de message spécifiques, car le client détermine si l’appareil prend en charge des fonctionnalités spécifiques.

Les sous-codes d’erreur suivants ne sont pas implémentés par WSDAPI :

InvalidMessageInformationHeader
MessageInformationHeaderRequired
UnsupportedExpirationType
InvalidMessage
FilteringNotSupported

Spécifications


Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	wsdutil.h (inclure Wsdapi.h)
Bibliothèque	Wsdapi.lib
DLL	Wsdapi.dll

Partager via