対象者:
SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analyticsアナリティクスプラットフォームシステム(PDW)Microsoft FabricにおけるSQLデータベース
基本的なレベルでは、メンバー関数は成功するか失敗するかのどちらかです。 ただし、関数が成功した場合も、その成功はアプリケーション開発者の意図とは異なる場合があります。
OLE DB のリターン コードの詳細については、「リターン コード (OLE DB)」を参照してください。
OLE DB Driver for SQL Server のメンバー関数が S_OK を返したときは、その関数は成功しています。
OLE DB Driver for SQL Server のメンバー関数が S_OK を返さない場合は、OLE/COM HRESULT をアンパックする FAILED マクロと IS_ERROR マクロにより、関数全体が成功したか失敗したかを判断できます。
FAILED または IS_ERROR が TRUE を返した場合、OLE DB Driver for SQL Server のコンシューマーは、メンバー関数の実行が失敗したことを確認できます。 FAILED または IS_ERROR が FALSE を返し、HRESULT が S_OK ではない場合、OLE DB Driver for SQL Server のコンシューマーは、部分的に関数が成功していることを確認できます。 コンシューマーは OLE DB Driver for SQL Server のエラー インターフェイスから返される、関数の成功に関する詳細情報を取得できます。 また、関数が明らかに失敗している (FAILED マクロが TRUE を返した) 場合、OLE DB Driver for SQL Server のエラー インターフェイスから拡張エラー情報を取得できます。
OLE DB Driver for SQL Server のコンシューマーは、HRESULT から返される、DB_S_ERRORSOCCURRED により成功が示される情報を取得する場合があります。 通常、DB_S_ERRORSOCCURRED を返すメンバー関数では、コンシューマーに状態値を提供するパラメーターが 1 つ以上定義されています。 コンシューマーは状態値パラメーターに返される情報以外のエラー情報を取得できない場合があるので、状態値が提供された場合にこの値を取得できるアプリケーション ロジックを実装することをお勧めします。
OLE DB Driver for SQL Server メンバーからは、成功コード S_FALSE は返されません。 OLE DB Driver for SQL Server のメンバー関数はすべて、成功を示す場合、常に S_OK を返します。