表21-6は、この項で説明している任意データ・セット・インタフェース関数を示しています。
表21-6 任意データ・セット関数
関数 | 用途 |
---|---|
|
新規のスケルトン・インスタンスを |
|
指定の継続時間に対して |
|
|
|
|
|
|
|
現行の位置にあるインスタンスに対応する |
|
|
構文
sword OCIAnyDataSetAddInstance ( OCISvcCtx *svchp, OCIError *errhp, OCIAnyDataSet *data_set, OCIAnyData **data );
パラメータ
OCIサービス・コンテキストです。
OCIエラー・ハンドルです。エラーがある場合は、err
に記録され、OCI_ERROR
が戻されます。OCIErrorGet()をコールして診断情報を取得します。
新規インスタンスを追加するOCIAnyDataSet
です。
新規に追加するインスタンスに対応するOCIAnyData
です。(*data)
がNULL
の場合、新規のOCIAnyData
はOCIAnyDataSet
と同じ継続時間の間割り当てられます。(*data)
がNULL
以外の場合は再使用されます。このOCIAnyData
は、後でOCIAnyDataConvert()コールを使用して構成したり、OCIAnyDataAttrSet()コールまたはOCIAnyDataCollAddElem()コールを使用してピース単位で構成することができます。
コメント
このコールは、このスケルトン・インスタンスをOCIAnyData
パラメータを介して戻します。このインスタンスは、後でOCIAnyData APIを呼び出して構成できます。
注意: 古い値は破棄されません。一連のコールを開始する前に、(*data )が指し示す古い値を破棄し、(*data )をNULL ポインタに設定する必要があります。戻されたOCIAnyData では、(OCIType 情報またはデータ部分の)ディープ・コピーは行われません。このOCIAnyData は、OCIAnyDataSet の割当て時間を超えて使用することはできません(OCIAnyDataSet への参照と同様です)。戻されたOCIAnyData をこの関数に対する後続のコールで再使用すると、新規のデータ・インスタンスをOCIAnyDataSet に後で追加できます。 |
構文
sword OCIAnyDataSetBeginCreate ( OCISvcCtx *svchp, OCIError *errhp, OCITypeCode typecode, const OCIType *type, OCIDuration dur, OCIAnyDataSet **data_set );
パラメータ
OCIサービス・コンテキストです。
OCIエラー・ハンドルです。エラーがある場合は、err
に記録され、OCI_ERROR
が戻されます。OCIErrorGet()をコールして診断情報を取得します。
OCIAnyDataSet
に対応する型コードです。
OCIAnyDataSet
に対応する型です。型コードが組込みの型(OCI_TYPECODE_NUMBER
など)に対応している場合、このパラメータはNULL
にできます。また、ユーザー定義型(OCI_TYPECODE_OBJECT
、OCI_TYPECODE_REF
、コレクション型など)の場合は、NULL
以外になります。
OCIAnyDataSet
が割り当てられる継続時間です。次のいずれかです。
初期化済のOCIAnyDataSet
です。
パラメータ
OCIサービス・コンテキストです。
OCIエラー・ハンドルです。エラーがある場合は、err
に記録され、OCI_ERROR
が戻されます。OCIErrorGet()をコールして診断情報を取得します。
解放されるOCIAnyDataSet
です。
パラメータ
OCIサービス・コンテキストです。
OCIエラー・ハンドルです。エラーがある場合は、err
に記録され、OCI_ERROR
が戻されます。OCIErrorGet()をコールして診断情報を取得します。
初期化済のOCIAnyDataSet
です。
構文
sword OCIAnyDataSetGetCount( OCISvcCtx *svchp, OCIError *errhp, OCIAnyDataSet *data_set, ub4 *count );
パラメータ
OCIサービス・コンテキストです。
OCIエラー・ハンドルです。エラーがある場合は、err
に記録され、OCI_ERROR
が戻されます。OCIErrorGet()をコールして診断情報を取得します。
正しい形式のOCIAnyDataSet
です。
OCIAnyDataSet
内のインスタンス数です。
構文
sword OCIAnyDataSetGetInstance ( OCISvcCtx *svchp, OCIError *errhp, OCIAnyDataSet *data_set, OCIAnyData **data );
パラメータ
OCIサービス・コンテキストです。
OCIエラー・ハンドルです。エラーがある場合は、err
に記録され、OCI_ERROR
が戻されます。OCIErrorGet()をコールして診断情報を取得します。
正しい形式のOCIAnyDataSet
です。
インスタンスに対応するOCIAnyData
です。(*data)がNULL
の場合、新規のOCIAnyData
はOCIAnyDataSet
と同じ継続時間の間割り当てられます。(*data
)がNULL
以外の場合は再使用されます。
構文
sword OCIAnyDataSetGetType ( OCISvcCtx *svchp, OCIError *errhp, OCIAnyDataSet *data_set, OCITypeCode *tc, OCIType **type );
パラメータ
OCIサービス・コンテキストです。
OCIエラー・ハンドルです。エラーがある場合は、err
に記録され、OCI_ERROR
が戻されます。OCIErrorGet()をコールして診断情報を取得します。
初期化済のOCIAnyDataSet
です。
OCIAnyDataSet
の型に対応する型コードです。
OCIAnyDataSet
に対応する型です。OCIAnyData
が組込みの型に対応している場合は、NULL
になります。