Funzione WSDGenerateFaultEx (wsdutil.h)

Genera un errore SOAP.

Sintassi

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

Parametri

[in] pCode

Codice di errore SOAP.

Di seguito è riportato l'elenco dei possibili codici di errore. Per una descrizione di ogni codice di errore, vedere

Specifica SOAP Versione 1.2.

VersionMismatch

MustUnderstand

DataEncodingUnknown

Mittente

Ricevitore

[in] pSubCode

Codice secondario di errore.

[in] pReasons

Struttura WSD_LOCALIZED_STRING_LIST che contiene un elenco di codici motivo localizzati.

[in] pszDetail

Contiene informazioni sull'errore specifiche dell'applicazione relative all'errore.

[out] ppFault

Struttura WSD_SOAP_FAULT che contiene l'errore generato. ppFault deve essere liberato con una chiamata a WSDFreeLinkedMemory.

Valore restituito

I valori restituiti possibili includono, ma non sono limitati ai seguenti:

Commenti

Gli errori SOAP consentono di comunicare le informazioni sugli errori sui messaggi SOAP non riusciti. Diversi protocolli di servizi Web estendono gli errori per fornire informazioni di errore contestuali e, in alcuni casi, come in WS-Eventing, gli errori sono una parte prevista di modelli di messaggi specifici perché il client determina se il dispositivo supporta funzionalità specifiche.

I seguenti codici secondari di errore non vengono implementati da WSDAPI:

• InvalidMessageInformationHeader
• MessageInformationHeaderRequired
• UnsupportedExpirationType
• InvalidMessage
• FilteringNotSupported

Requisiti