COleException クラスCOleException Class

OLE 操作に関する例外条件を表します。Represents an exception condition related to an OLE operation.

構文Syntax

class COleException : public CException

メンバーMembers

パブリック メソッドPublic Methods

名前Name 説明Description
COleException::P rocessCOleException::Process キャッチされた例外を OLE のリターンコードに変換します。Translates a caught exception into an OLE return code.

パブリック データ メンバーPublic Data Members

名前Name 説明Description
COleException:: m_scCOleException::m_sc 例外の理由を示すステータスコードを格納します。Contains the status code that indicates the reason for the exception.

解説Remarks

クラスには、 COleException 例外の原因を示す状態コードを保持するパブリックデータメンバーが含まれています。The COleException class includes a public data member that holds the status code indicating the reason for the exception.

一般に、オブジェクトを直接作成することは避けてください。 COleException 代わりに、 AfxThrowOleExceptionを呼び出す必要があります。In general, you should not create a COleException object directly; instead, you should call AfxThrowOleException.

例外の詳細については、「 例外処理 (MFC) 」および「 例外: OLE 例外」を参照してください。For more information on exceptions, see the articles Exception Handling (MFC) and Exceptions: OLE Exceptions.

継承階層Inheritance Hierarchy

CObjectCObject

CExceptionCException

COleException

要件Requirements

ヘッダー : afxdisp.hHeader: afxdisp.h

COleException:: m_scCOleException::m_sc

このデータメンバーは、例外の原因を示す OLE ステータスコードを保持します。This data member holds the OLE status code that indicates the reason for the exception.

SCODE m_sc;

解説Remarks

この変数の値は、 AfxThrowOleExceptionによって設定されます。This variable's value is set by AfxThrowOleException.

SCODE の詳細については、「Windows SDK の COM エラーコードの構造 」を参照してください。For more information on SCODE, see Structure of COM Error Codes in the Windows SDK.

Example

try
{
   SomeOleFunc();
}
catch (COleException* pe)
{
   TRACE(_T("COleException caught. SCODE = %x\n"), pe->m_sc);
   pe->Delete();
}

COleException::P rocessCOleException::Process

キャッチされた例外を OLE ステータスコードに変換するには、 プロセス メンバー関数を呼び出します。Call the Process member function to translate a caught exception into an OLE status code.

static SCODE PASCAL Process(const CException* pAnyException);

パラメーターParameters

pAnyExceptionpAnyException
キャッチされた例外へのポインター。Pointer to a caught exception.

戻り値Return Value

OLE ステータスコード。An OLE status code.

解説Remarks

注意

この関数は static です。This function is static.

SCODE の詳細については、「Windows SDK の COM エラーコードの構造 」を参照してください。For more information on SCODE, see Structure of COM Error Codes in the Windows SDK.

Example

COleDispatchDriver::CreateDispatchの例を参照してください。See the example for COleDispatchDriver::CreateDispatch.

関連項目See also

MFC のサンプル CALCDRIVMFC Sample CALCDRIV
CException クラスCException Class
階層図Hierarchy Chart