A プロバイダ固有の情報

次の各項では、Oracle Provider for OLE DBに固有のOLE DB情報について説明します。すべてのOLE DBプロパティおよびインタフェースの詳細なリストを含むOLE DBの一般的な情報については、Microsoft社のOLE DB Programmer's Reference Guideを参照してください。

行セットおよびパラメータのデータ型マッピング

ここでは、Oracleデータ型とOLE DBで定義される型の間のデータ型マッピングのリストを示します。Oracle Provider for OLE DBは、パラメータと同様に行セットでもOLE DBで定義される特定のデータ型を使用して、Oracleデータ型を表します。OLE DBで定義される型は、表を作成するときにもOracleデータ型にマッピングされます。

それぞれの Oracleデータ型が、次の表に示すように特定の OLE DBデータ型にマッピングされます。この対応関係は、データ型の情報がOracle Databaseから取り出されるときに使用されます。

表A-1 データ型マッピング

Oracleデータ型	OLE DBデータ型 - 通常(非Unicode)モード	OLE DBデータ型 - Unicodeモード
`BFILE`	`DBTYPE_BYTES`	`DBTYPE_BYTES`
`BINARY_FLOAT`	`DBTYPE_R4`	`DBTYPE_R4`
`BINARY_DOUBLE`	`DBTYPE_R8`	`DBTYPE_R8`
`BLOB`	`DBTYPE_BYTES`	`DBTYPE_BYTES`
`CHAR`	`DBTYPE_STR`	`DBTYPE_WSTR`
`CLOB`	`DBTYPE_STR`	`DBTYPE_WSTR`
`DATE`	`DBTYPE_DBTIMESTAMP`	`DBTYPE_DBTIMESTAMP`
`FLOAT`	`DBTYPE_R8`	`DBTYPE_R8`
`INTERVAL` `DAY` `TO` `SECOND`	`DBTYPE_STR`	`DBTYPE_WSTR`
`INTERVAL` `YEAR` `TO` `MONTH`	`DBTYPE_STR`	`DBTYPE_WSTR`
`LONG`	`DBTYPE_STR`	`DBTYPE_WSTR`
`LONG RAW`	`BTYPE_BYTES`	`DBTYPE_BYTES`
`NCHAR`	`DBTYPE_STR`	`DBTYPE_WSTR`
`NCLOB`	`DBTYPE_STR`	`DBTYPE_WSTR`
`NUMBER`	`DBTYPE_VARNUMERIC`	`DBTYPE_VARNUMERIC`
`NUMBER(p,s)`	`DBTYPE_NUMERIC`	`DBTYPE_NUMERIC`
`NVARCHAR2`	`DBTYPE_STR`	`DBTYPE_WSTR`
`RAW`	`DBTYPE_BYTES`	`DBTYPE_BYTES`
`ROWID`	`DBTYPE_STR`	`DBTYPE_STR`
`TIMESTAMP`	`DBTYPE_DBTIMESTAMP`	`DBTYPE_DBTIMESTAMP`
`TIME` `WITH` `TIME` `ZONE`	`DBTYPE_DBTIMESTAMP`	`DBTYPE_DBTIMESTAMP`
`TIMESTAMP` `WITH` `LOCAL` `TIME` `ZONE`	`DBTYPE_DBTIMESTAMP`	`DBTYPE_DBTIMESTAMP`
`VARCHAR`	`DBTYPE_STR`	`DBTYPE_WSTR`

サポートされるプロパティ

ここでは、Oracle Provider for OLE DBでサポートされるプロパティのリストを示します。読取り/書込みの状態と初期値も示します。

データソース・プロパティ

表A-2は、データソースのプロパティの一覧です。

表A-2 DBPROPSET_DATASOURCEプロパティ

プロパティ	状態	初期値
`DBPROP_CURRENTCATALOG`	読取り専用	`NULL`

DataSourceInfoプロパティ

表A-3は、DataSourceInfoのプロパティの一覧です。

表A-3 DBPROPSET_DATASOURCEINFOプロパティ

プロパティ	状態	初期値
`DBPROP_ACTIVESESSIONS`	読取り専用	`0`、無制限セッション
`DBPROP_ASYNCTXNABORT`	読取り専用	`VARIANT_FALSE`
`DBPROP_ASYNCTXNCOMMIT`	読取り専用	`VARIANT_FALSE`
`DBPROP_BYREFACCESSORS`	読取り専用	`VARIANT_TRUE`
`DBPROP_CATALOGLOCATION`	読取り専用	`DBPROPVAL_CL_END`
`DBPROP_CATALOGTERM`	読取り専用	"Database link"
`DBPROP_CATALOGUSAGE`	読取り専用	`DBPROPVAL_CU_DML_STATEMENTS`
`DBPROP_COLUMNDEFINITION`	読取り専用	`DBPROPVAL_CD_NOTNULL`
`DBPROP_CONCATNULLBEHAVIOR`	読取り専用	`DBPROPVAL_CB_NON_NULL`
`DBPROP_CONNECTIONSTATUS`	読取り専用	`DBPROPVAL_CS_INITIALIZED`
`DBPROP_DATASOURCENAME`	読取り専用	" "、実行時に設定
`DBPROP_DATASOURCEREADONLY`	読取り専用	`VARIANT_FALSE`
`DBPROP_DBMSNAME`	読取り専用	" "、実行時に設定
`DBPROP_DBMSVER`	読取り専用	実行時に設定
`DBPROP_DSOTHREADMODEL`	読取り/書込み	`DBPROPVAL_RT_FREETHREAD`
`DBPROP_GROUPBY`	読取り専用	`DBPROPVAL_GB_CONTAINS_SELECT`
`DBPROP_HETEROGENEOUSTABLES`	読取り専用	`DBPROPVAL_HT_DIFFERENT_CATALOGS`
`DBPROP_IDENTIFIERCASE`	読取り専用	`DBPROPVAL_IC_UPPER`
`DBPROP_MAXINDEXSIZE`	読取り専用	`0`、制限はブロックサイズに依存
`DBPROP_MAXOPENCHAPTERS`	読取り専用	`0`, 未サポート
`DBPROP_MAXORSINFILTER`	読取り専用	`0`, 未サポート
`DBPROP_MAXROWSIZE`	読取り専用	`0`、制限なし
`DBPROP_MAXROWSIZEINCLUDESBLOB`	読取り専用	`VARIANT_FALSE`
`DBPROP_MAXSORTCOLUMNS`	読取り専用	`0`, 未サポート
`DBPROP_MAXTABLESINSELECT`	読取り専用	0、制限なし
`DBPROP_MULTIPLEPARAMSETS`	読取り専用	`VARIANT_TRUE`
`DBPROP_MULTIPLERESULTS`	読取り専用	`DBPROP_MR_SUPPORTED \| DBPROPVAL__MR_CONCURRENT`
`DBPROP_MULTIPLESTORAGEOBJECTS`	読取り専用	`VARIANT_FALSE`
`DBPROP_MULTITABLEUPDATE`	読取り専用	`VARIANT_FALSE`
`DBPROP_NULLCOLLATION`	読取り専用	`DBPROPVAL_NC_HIGH`
`DBPROP_OLEOBJECTS`	読取り専用	`DBPROPVAL_OO_BLOB`
`DBPROP_ORDERBYCOLUMNSINSELECT`	読取り専用	`VARIANT_FALSE`
`DBPROP_OUTPUTPARAMETERAVAILABILITY`	読取り専用	`DBPROPVAL_OA_ATEXECUTE`
`DBPROP_PERSISTENTIDTYPE`	読取り専用	`DBPROPVAL_PT_NAME`
`DBPROP_PREPAREABORTBEHAVIOR`	読取り専用	`DBPROPVAL_CB_PRESERVE`
`DBPROP_PREPARECOMMITBEHAVIOR`	読取り専用	`DBPROPVAL_CB_PRESERVE`
`DBPROP_PROCEDURETERM`	読取り専用	"PL/SQL Stored Procedure"
`DBPROP_PROVIDERFRIENDLYNAME`	読取り専用	"Oracle Provider for OLE DB"
`DBPROP_PROVIDERNAME`	読取り専用	`OraOLEDBver.dll`
`DBPROP_PROVIDEROLEDBVER`	読取り専用	"02.01"
`DBPROP_PROVIDERVER`	読取り専用	現在のOraOLEDBバージョンに設定
`DBPROP_QUOTEDIDENTIFIERCASE`	読取り専用	`DBPROPVAL_IC_SENSITIVE`
`DBPROP_ROWSETCONVERSIONSONCOMMAND`	読取り専用	`VARIANT_TRUE`
`DBPROP_SCHEMATERM`	読取り専用	"Owner"
`DBPROP_SCHEMAUSAGE`	読取り専用	`DBPROPVAL_SU_DML_STATEMENTS \| DBPROPVAL_SU_TABLE_DEFINITION \| DBPROPVAL_SU_INDEX_DEFINITION \| DBPROPVAL_SU_PRIVILEGE_DEFINITION`
`DBPROP_SERVERNAME`	読取り専用	" "、実行時に設定
`DBPROP_SORTONINDEX`	読取り専用	`VARIANT_FALSE`
`DBPROP_SQLSUPPORT`	読取り専用	`DBPROPVAL_SQL_ODBC_MINIMUM \| DBPROPVAL_SQL_ANSI92_ENTRY \| DBPROPVAL_SQL_ESCAPECLAUSES`
`DBPROP_STRUCTUREDSTORAGE`	読取り専用	`DBPROPVAL_SS_ISEQUENTIAL_STREAM`
`DBPROP_SUBQUERIES`	読取り専用	`DBPROPVAL_SQ_CORRELATEDSUBQUERIES`
`DBPROP_SUPPORTEDTXNDDL`	読取り専用	`DBPROPVAL_TC_DDL_COMMIT`
`DBPROP_SUPPORTEDTXNISOLEVELS`	読取り専用	`DBPROPVAL_TI_CURSORSTABILITY \| DBPROPVAL_TI_READCOMMITTED`
`DBPROP_SUPPORTEDTXNISORETAIN`	読取り専用	`DBPROPVAL_TR_DONTCARE`
`DBPROP_TABLETERM`	読取り専用	"Table"
`DBPROP_USERNAME`	読取り専用	" "、実行時に設定

初期化のプロパティと認可のプロパティ

表A-4は、初期化のプロパティと認可のプロパティの一覧です。

表A-4 DBPROPSET_DBINITプロパティ

プロパティ	状態	初期値
`DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO`	読取り専用	`VARIANT_FALSE`
`DBPROP_AUTH_USERID`	読取り/書込み	ユーザーID
`DBPROP_INIT_DATASOURCE`	読取り/書込み	接続文字列
`DBPROP_INIT_HWND`	読取り/書込み	プロンプト用のウィンドウ・ハンドル
`DBPROP_INIT_LCID`	読取り/書込み	システムのLCID
`DBPROP_INIT_OLEDBSERVICES`	読取り/書込み	`DBPROPVAL_OS_ENABLEALL`
`DBPROP_INIT_PROMPT`	読取り/書込み	`DBPROMPT_NOPROMPT`

セッションのプロパティ

表A-5は、セッションのプロパティの一覧です。

表A-5 DBPROPSET_SESSIONプロパティ

プロパティ	状態	初期値
`DBPROP_SESS_AUTOCOMMITISOLEVELS`	読取り専用	`DBPROPVAL_TI_CURSORSTABILITY \| DBPROPVAL_TI_READCOMMITTED`

行セットのプロパティ

表A-6は、行セットのプロパティの一覧です。

表A-6 DBPROPSET_ROWSETプロパティ

プロパティ	状態	初期値
`DBPROP_ABORTPRESERVE`	読取り/書込み	`VARIANT_TRUE`
`DBPROP_ACCESSORORDER`	読取り専用	`DBPROP_AO_RANDOM`
`DBPROP_APPENDONLY`	読取り専用	`VARIANT_FALSE`
`DBPROP_BLOCKINGSTORAGEOBJECTS`	読取り専用	`VARIANT_FALSE`
`DBPROP_BOOKMARKINFO`	読取り専用	`0`
`DBPROP_BOOKMARKS`	読取り/書込み	`VARIANT_FALSE`
`DBPROP_BOOKMARKSKIPPED`	読取り/書込み	`VARIANT_TRUE`
`DBPROP_BOOKMARKTYPE`	読取り専用	`DBPROP_BMK_NUMERIC`
`DBPROP_CACHEDEFERRED`	読取り専用	`VARIANT_FALSE`
`DBPROP_CANFETCHBACKWARDS`	読取り/書込み	`VARIANT_FALSE`
`DBPROP_CANHOLDROWS`	読取り/書込み	`VARIANT_FALSE`
`DBPROP_CANSCROLLBACKWARDS`	読取り/書込み	`VARIANT_FALSE`
`DBPROP_CHANGEINSERTEDROWS`	読取り専用	`VARIANT_TRUE`
`DBPROP_CLIENTCURSOR`	読取り/書込み	`VARIANT_TRUE`
`DBPROP_COLUMNRESTRICT`	読取り専用	`VARIANT_TRUE`
`DBPROP_COMMANDTIMEOUT`	読取り/書込み	`0`
`DBPROP_COMMITPRESERVE`	読取り/書込み	`VARIANT_TRUE`
`DBPROP_DEFERRED`	読取り専用	`VARIANT_TRUE`
`DBPROP_DELAYSTORAGEOBJECTS`	読取り専用	`VARIANT_TRUE`、遅延更新なし
`DBPROP_FINDCOMPAREOPS`	読取り専用	`DBPROPVAL_CO_EQUALITY \| DBPROPVAL_CO_STRING \| DBPROPVAL_CO_CASESENSITIVE \| DBPROPVAL_CO_CASEINSENSITIVE \| DBPROPVAL_CO_CONTAINS \| DBPROPVAL_CO_BEGINSWITH`
`DBPROP_HIDDENCOLUMNS`	読取り専用	`0`
`DBPROP_IACCESSOR`	読取り専用	`VARIANT_TRUE`
`DBPROP_ICOLUMNSINFO`	読取り専用	`VARIANT_TRUE`
`DBPROP_ICOLUMNSROWSET`	読取り/書込み	`VARIANT_TRUE`
`DBPROP_ICONNECTIONPOINTCONTAINER`	読取り専用	`VARIANT_TRUE`
`DBPROP_ICONVERTTYPE`	読取り専用	`VARIANT_TRUE`
`DBPROP_IMMOBILEROWS`	読取り専用	`VARIANT_TRUE`
`DBPROP_IMULTIPLERESULTS`	読取り/書込み	`VARIANT_TRUE`
`DBPROP_IROWSET`	読取り専用	`VARIANT_TRUE`
`DBPROP_IROWSETCHANGE`	読取り/書込み	`VARIANT_FALSE`
`DBPROP_IROWSETFIND`	読取り/書込み	`VARIANT_FALSE`
`DBPROP_IROWSETIDENTITY`	読取り専用	`VARIANT_TRUE`
`DBPROP_IROWSETINFO`	読取り専用	`VARIANT_TRUE`
`DBPROP_IROWSETLOCATE`	読取り/書込み	`VARIANT_FALSE`
`DBPROP_IROWSETREFRESH`	読取り/書込み	`VARIANT_FALSE`
`DBPROP_IROWSETSCROLL`	読取り/書込み	`VARIANT_FALSE`
`DBPROP_IROWSETUPDATE`	読取り/書込み	`VARIANT_FALSE`
`DBPROP_ISEQUENTIALSTREAM`	読取り/書込み	`VARIANT_TRUE`
`DBPROP_ISUPPORTERRORINFO`	読取り/書込み	`VARIANT_TRUE`
`DBPROP_LITERALBOOKMARKS`	読取り専用	`VARIANT_FALSE`
`DBPROP_LITERALIDENTITY`	読取り専用	`VARIANT_FALSE`
`DBPROP_LOCKMODE`	読取り専用	`DBPROPVAL_LM_NONE`
`DBPROP_MAXOPENROWS`	読取り/書込み	`0`, 無制限
`DBPROP_MAXPENDINGROWS`	読取り専用	`0`, 無制限
`DBPROP_MAXROWS`	読取り/書込み	`0`
`DBPROP_MAXROWSIZE`	読取り専用	`0`
`DBPROP_MAXROWSIZEINCLUDESBLOB`	読取り専用	`VARIANT_FALSE`
`DBPROP_NOTIFICATIONGRANULARITY`	読取り/書込み	`DBPROPVAL_NT_MULTIPLEROWS`
`DBPROP_NOTIFICATIONPHASES`	読取り/書込み	`DBPROPVAL_NP_OKTODO \| DBPROPVAL_NP_ABOUTTODO \| DBPROPVAL_NP_SYNCHAFTER \| DBPROPVAL_NP_FAILEDTODO \| DBPROPVAL_NP_DIDEVENT`
`DBPROP_NOTIFYCOLUMNSET`	読取り/書込み	`DBPROPVAL_NP_OKTODO \| DBPROPVAL_NP_ABOUTTODO \| DBPROPVAL_NP_SYNCHAFTER \| DBPROPVAL_NP_FAILEDTODO \| DBPROPVAL_NP_DIDEVENT`
`DBPROP_NOTIFYROWDELETE`	読取り/書込み	`DBPROPVAL_NP_OKTODO \| DBPROPVAL_NP_ABOUTTODO \| DBPROPVAL_NP_SYNCHAFTER \| DBPROPVAL_NP_FAILEDTODO \| DBPROPVAL_NP_DIDEVENT`
`DBPROP_NOTIFYROWFIRSTCHANGE`	読取り/書込み	`DBPROPVAL_NP_OKTODO \| DBPROPVAL_NP_ABOUTTODO`
`DBPROP_NOTIFYROWINSERT`	読取り/書込み	`DBPROPVAL_NP_OKTODO \| DBPROPVAL_NP_ABOUTTODO \| DBPROPVAL_NP_SYNCHAFTER \| DBPROPVAL_NP_FAILEDTODO \| DBPROPVAL_NP_DIDEVENT`
`DBPROP_NOTIFYROWRESYNCH`	読取り/書込み	`DBPROPVAL_NP_OKTODO \| DBPROPVAL_NP_ABOUTTODO \| DBPROPVAL_NP_SYNCHAFTER`
`DBPROP_NOTIFYROWSETRELEASE`	読取り/書込み	`DBPROPVAL_NP_OKTODO \| DBPROPVAL_NP_ABOUTTODO \| DBPROPVAL_NP_SYNCHAFTER`
`DBPROP_NOTIFYROWSETFETCHPOSITIONCHANGE`	読取り/書込み	`DBPROPVAL_NP_OKTODO \| DBPROPVAL_NP_ABOUTTODO \| DBPROPVAL_NP_SYNCHAFTER`
`DBPROP_NOTIFYROWUNDOCHANGE`	読取り/書込み	`DBPROPVAL_NP_OKTODO \| DBPROPVAL_NP_ABOUTTODO \| DBPROPVAL_NP_SYNCHAFTER \| DBPROPVAL_NP_FAILEDTODO \| DBPROPVAL_NP_DIDEVENT`
`DBPROP_NOTIFYROWUNDODELETE`	読取り/書込み	`DBPROPVAL_NP_OKTODO \| DBPROPVAL_NP_ABOUTTODO \| DBPROPVAL_NP_SYNCHAFTER \| DBPROPVAL_NP_FAILEDTODO \| DBPROPVAL_NP_DIDEVENT`
`DBPROP_NOTIFYROWUNDOINSERT`	読取り/書込み	`DBPROPVAL_NP_OKTODO \| DBPROPVAL_NP_ABOUTTODO \| DBPROPVAL_NP_SYNCHAFTER \| DBPROPVAL_NP_FAILEDTODO \| DBPROPVAL_NP_DIDEVENT`
`DBPROP_NOTIFYROWUNDOUPDATE`	読取り/書込み	`DBPROPVAL_NP_OKTODO \| DBPROPVAL_NP_ABOUTTODO \| DBPROPVAL_NP_SYNCHAFTER \| DBPROPVAL_NP_FAILEDTODO \| DBPROPVAL_NP_DIDEVENT`
`DBPROP_ORDEREDBOOKMARKS`	読取り専用	`VARIANT_TRUE`
`DBPROP_OTHERINSERT`	読取り専用	`VARIANT_FALSE`
`DBPROP_OTHERUPDATEDELETE`	読取り専用	`VARIANT_FALSE`
`DBPROP_OWNINSERT`	読取り専用	`VARIANT_TRUE`
`DBPROP_OWNUPDATEDELETE`	読取り専用	`VARIANT_TRUE`
`DBPROP_QUICKRESTART`	読取り/書込み	`VARIANT_FALSE`
`DBPROP_REENTRANTEVENTS`	読取り専用	`VARIANT_FALSE`
`DBPROP_REMOVEDELETED`	読取り専用	`VARIANT_TRUE`
`DBPROP_REPORTMULTIPLECHANGES`	読取り専用	`VARIANT_FALSE`
`DBPROP_RETURNPENDINGINSERTS`	読取り/書込み	`VARIANT_TRUE`
`DBPROP_ROWRESTRICT`	読取り/書込み	`VARIANT_FALSE`
`DBPROP_ROWTHREADMODEL`	読取り専用	`DBPROPVAL_RT_FREETHREAD`
`DBPROP_SERVERCURSOR`	読取り/書込み	`VARIANT_FALSE`
`DBPROP_SERVERDATAONINSERT`	読取り/書込み	`VARIANT_TRUE`
`DBPROP_STRONGIDENTITY`	読取り/書込み	`VARIANT_TRUE`
`DBPROP_TRANSACTEDOBJECT`	読取り専用	`VARIANT_TRUE`
`DBPROP_UNIQUEROWS`	読取り/書込み	`VARIANT_FALSE`
`DBPROP_UPDATABILITY`	読取り/書込み	`DBPROPVAL_UP_CHANGE \| DBPROPVAL_UP_DELETE \| DBPROPVAL_UP_INSET`

行セットのプロパティの含意

特定のプロパティがVARIANT_TRUEに設定されている場合、Oracle Provider for OLE DBは、その他の必要なプロパティを設定します。

DBPROP_IROWSETLOCATEにVARIANT_TRUEが設定されている場合、次のプロパティにもVARIANT_TRUEが設定されます。
- DBPROP_IROWSETIDENTITY
- DBPROP_CANHOLDROWS
- DBPROP_BOOKMARKS
- DBPROP_CANFETCHBACKWARDS
- DBPROP_CANSCROLLBACKWARDS
DBPROP_IROWSETSCROLLにVARIANT_TRUEが設定されている場合、次のプロパティにもVARIANT_TRUEが設定されます。
- DBPROP_IROWSETIDENTITY
- DBPROP_IROWSETLOCATE
- DBPROP_CANHOLDROWS
- DBPROP_BOOKMARKS
- DBPROP_CANFETCHBACKWARDS
- DBPROP_CANSCROLLBACKWARDS
DBPROP_IROWSETUPDATEにVARIANT_TRUEが設定されている場合、DBPROP_IROWSETCHANGEプロパティにもVARIANT_TRUEが設定されます。

サポートされるインタフェース

ここでは、Oracle Provider for OLE DBでサポートされるOLE DBインタフェースを示します。

データ・ソース

   CoType TDataSource {
      interface IDBCreateSession;
      interface IDBInitialize;
      interface IDBProperties;
      interface IPersist;
      interface IDBInfo;
      interface ISupportErrorInfo;
   }

セッション

   CoType TSession {
      interface IGetDataSource;
      interface IOpenRowset;
      interface ISessionProperties;
      interface IDBCreateCommand;
      interface IDBSchemaRowset;
      interface ISupportErrorInfo;
      interface ITransactionJoin;
      interface ITransactionLocal;
      interface ITransaction;
   }

コマンド

   CoType TCommand {
      interface IAccessor;
      interface IColumnsInfo;
      interface ICommand;
      interface ICommandProperties;
      interface ICommandText;
      interface IConvertType;
      interface IColumnsRowset;
      interface ICommandPrepare;
      interface ICommandWithParameters;
      interface ISupportErrorInfo;
   }

行セット

   CoType TRowset {
      interface IAccessor;
      interface IColumnsInfo;
      interface IConvertType;
      interface IRowset;
      interface IRowsetInfo;
      interface IColumnsRowset;
      interface IConnectionPointContainer;
      interface IRowsetChange;
      interface IRowsetFind;
      interface IRowsetIdentity;
      interface IRowsetLocate;
      interface IRowsetRefresh;
      interface IRowsetFastLoad;
      interface IRowsetScroll;
      interface IRowsetUpdate;
      interface ISupportErrorInfo;
   }

複数結果

   CoType TMultipleResults {
      interface IMultipleResults;
      interface ISupportErrorInfo;
   }

トランザクションのオプション

   CoType TTransactionOptions {
      interface ITransactionOptions;
      interface ISupportErrorInfo;
   }

カスタム・エラー・オブジェクト

   CoType TCustomErrorObject {
      interface IErrorLookup;
   }

サポートされるメタデータ列

DBTYPE_BASECOLUMNNAME、DBTYPE_BASETABLENAMEおよびDBTYPE_BASESCHEMANAMEの各メタデータ列には、読取り専用レコードセット用のデータは移入されません。OraOLEDBは、DISTINCTまたはUNIQUEキーワードを使用したSQL問合せのためのサーバー・カーソル用読取り専用レコードセットを作成します。OraOLEDBは、JOIN問合せのためのサーバー・カーソル用読取り専用レコードセットも作成します。

次のメタデータ列は、OraOLEDBの列の行セットでサポートされます。

DBCOLUMN_IDNAME
DBCOLUMN_PROPID
DBCOLUMN_NAME
DBCOLUMN_NUMBER
DBCOLUMN_TYPE
DBCOLUMN_TYPEINFO
DBCOLUMN_COLUMNSIZE
DBCOLUMN_PRECISION
DBCOLUMN_SCALE
DBCOLUMN_FLAGS
DBCOLUMN_BASECATALOGNAME
DBCOLUMN_BASECOLUMNNAME
DBCOLUMN_BASESCHEMANAME
DBCOLUMN_BASETABLENAME
DBCOLUMN_COMPUTEMODE
DBCOLUMN_ISAUTOINCREMENT
DBCOLUMN_ISCASESENSITIVE
DBCOLUMN_ISSEARCHABLE
DBCOLUMN_OCTETLENGTH
DBCOLUMN_KEYCOLUMN

OraOLEDBトレース

OraOLEDBには、デバッグを目的とする、インタフェース・コールのトレース機能があります。この機能は、顧客の問題をデバッグする際に、Oracleサポート・サービスの役に立つよう提供されています。

プロバイダは、次の情報を記録するように構成できます。

OLE DBインタフェース・メソッドの入力および出力
- 提供されているパラメータ値(入力)
- 戻り値、HRESULT(出力)
- スレッドID(開始および終了)
分散トランザクションの登録および登録解除
- セッション・オブジェクト情報
- トランザクションID
  
  注意:
  グローバル・トランザクションの登録および登録解除情報を記録するには、TraceLevel値にセッション・オブジェクトを設定する必要があります。コールをトレースするためのレジストリ設定のTraceOptionを参照してください。

コールをトレースするためのレジストリ設定

ODAC 12c リリース4では、OraOLEDBがデフォルトでトレース・ファイルを書き込むために次の新しいディレクトリを使用するようになりました: <Windows user temporary folder>\oledb\trace。

Windowsユーザーの一時フォルダは、Windows TMPまたはTEMP環境変数など、ローカルのWindows設定で定義されています。通常、C:\tempまたはC:\Users\<user name>\AppData\Local\Tempです。

トレース・ファイルの場所を変更するには、TraceFileLocation属性を使用して新しい場所を設定します。TraceFileLocationは、デフォルトではWindowsレジストリに作成されません。OraOLEDBは、トレース・ファイルを作成するたびにトレースが作成されたWindowsイベント・ログにエントリを作成します。

インタフェース・コールをトレースするには、HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE\KEY_HOMENAME\OLEDB\に対して次のレジストリ値を構成する必要があります。

TraceFileLocation

有効な値: 任意の有効なディレクトリ・パス

TraceFileLocationは、トレース・ファイルの保存先ディレクトリを指定します。デフォルトのトレースの場所は<Windows user temporary folder>\oledb\traceです。
TraceCategory

有効な値:
- 0 = なし
- 1 = OLEDBインタフェース・メソッドの入力
- 2 = OLEDBインタフェース・メソッドの出力
- 4 = 分散トランザクションの登録および登録解除
TraceCategoryは、トレースする情報を指定します。有効値を加算することによって、異なるトレース・カテゴリの組合せを作成できます。たとえば、TraceCategoryに3を設定すると、すべてのOLE DBインタフェース・メソッドの入力と出力がトレースされます。
TraceLevel

有効な値:
- 0 = なし
- 1 = データソース・オブジェクト
- 2 = セッション・オブジェクト
- 4 = コマンド・オブジェクト
- 8 = 行セット・オブジェクト
- 16 = エラー・オブジェクト
- 64 = 複数結果オブジェクト
TraceLevelは、トレースするOLE DBオブジェクトを指定します。すべてのOLE DBオブジェクトに対するすべての入出力のコールをトレースする必要はない場合、TraceLevelによって、トレース対象を1つまたは複数のOLE DBオブジェクトに限定できます。複数のオブジェクトに対するトレースを取得するには、有効値を加算します。たとえば、TraceLevelが12に、TraceCategoryが3に設定されている場合は、トレース・ファイルにはコマンド・オブジェクトと行セット・オブジェクトに対するメソッドの入出力のみが含まれます。

グローバル・トランザクションの登録および登録解除情報をトレースするには、TraceLevel値にセッション・オブジェクト(2)を設定する必要があります。
TraceOption

有効な値:
- 0 = 単一のトレース・ファイル
- 1 = 複数のトレース・ファイル
TraceOptionは、各スレッドIDに対してトレース情報を単一のファイルと複数のファイルのどちらに記録するかを指定します。複数のトレース・ファイルが要求されている場合は、各スレッドのトレース・ファイルを作成するために指定されたファイル名にスレッドIDが追加されます。