次の方法で共有

WSDGenerateFault 関数 (wsdutil.h)

  • [アーティクル]

SOAP エラーを生成します。

構文

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

パラメーター

[in] pszCode

SOAP エラー コード。

考えられるエラー コードの一覧を次に示します。 各エラー コードの説明については、 SOAP バージョン 1.2 の仕様を参照してください。

VersionMismatch

MustUnderstand

DataEncodingUnknown

送信者

受信者

[in] pszSubCode

障害サブコード。

[in] pszReason

エラーの人間が判読できる説明。

[in] pszDetail

エラーに関連するアプリケーション固有のエラー情報が含まれます。

[in] pContext

エラーを生成するコンテキストを表す IWSDXMLContext インターフェイス。

[out] ppFault

生成されたエラーを含む WSD_SOAP_FAULT 構造体。 呼び出し元のアプリケーションがこのデータで行われる場合、WSDFreeLinkedMemory の呼び出しで ppFault を解放する必要があります。

戻り値

可能な戻り値には、次のものが含まれますが、これらに限定されません。

リターン コード 説明
S_OK
 メソッドが正常に完了しました。
E_INVALIDARG
 pszCode、 pszReason、または pContext が NULL です。
E_POINTER
 ppFault は NULL です。

解説

SOAP エラーは、失敗した SOAP メッセージに関するエラー情報を伝える方法を提供します。 さまざまな Web サービス プロトコルによってエラーが拡張され、コンテキスト エラー情報が提供されます。場合によっては、WS-Eventing のように、クライアントがデバイスが特定の機能をサポートしているかどうかを判断する際に、エラーが特定のメッセージ パターンの一部として想定されます。

次のエラー サブコードは、WSDAPI によって実装されません。

  • InvalidMessageInformationHeader
  • MessageInformationHeaderRequired
  • UnsupportedExpirationType
  • InvalidMessage
  • FilteringNotSupported

要件

   
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー wsdutil.h (Wsdapi.h を含む)
Library Wsdapi.lib
[DLL] Wsdapi.dll