Funzione WSDGenerateFault (wsdutil.h)

Genera un errore SOAP.

Sintassi

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

Parametri

[in] pszCode

Codice di errore SOAP.

L'elenco dei possibili codici di errore segue. Per una descrizione di ogni codice di errore, vedere la specifica SOAP versione 1.2.

VersionMismatch

MustUnderstand

DataEncodingUnknown

Mittente

Ricevitore

[in] pszSubCode

Codice secondario di errore.

[in] pszReason

Spiegazione leggibile dell'errore.

[in] pszDetail

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

[in] pContext

Interfaccia IWSDXMLContext che rappresenta il contesto in cui generare l'errore.

[out] ppFault

Struttura WSD_SOAP_FAULT contenente l'errore generato. Quando l'applicazione chiamante viene eseguita con questi dati, ppFault deve essere liberata con una chiamata a WSDFreeLinkedMemory.

Valore restituito

I valori restituiti possibili includono, ma non sono limitati a, quanto segue:

Commenti

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

I sottocodice di errore seguenti non vengono implementati da WSDAPI:

• InvalidMessageInformationHeader
• MessageInformationHeaderRequired
• UnsupportedExpirationType
• InvalidMessage
• FiltroNotSupported

Requisiti