Partager via

Fonction WSDGenerateFaultEx (wsdutil.h)

  • Article

Génère une erreur SOAP.

Syntaxe

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

Paramètres

[in] pCode

Code d’erreur SOAP.

La liste des codes d’erreur possibles suit. Pour obtenir une description de chaque code d’erreur, consultez

Spécification SOAP Version 1.2.

VersionMismatch

MustUnderstand

DataEncodingUnknown

Expéditeur

Destinataire

[in] pSubCode

Sous-code d’erreur.

[in] pReasons

Une structure WSD_LOCALIZED_STRING_LIST qui contient une liste de codes de raison localisés.

[in] pszDetail

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

[out] ppFault

Structure WSD_SOAP_FAULT qui contient l’erreur générée. 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
 Méthode terminée avec succès.
E_INVALIDARG
 pszCode ou pReasons a la valeur NULL.
E_POINTER
 ppFault a la valeur NULL.

Remarques

Les erreurs SOAP permettent de communiquer les informations d’erreur sur les messages SOAP ayant échoué. Différents protocoles des 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 ou non 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