sp_cursoroption (Transact-SQL)
適用対象: 
SQL Server
カーソル オプションを設定するか、 sp_cursoropen ストアド プロシージャによって作成されたカーソル情報を返します。 sp_cursoroption は、表形式データ ストリーム (TDS) パケットで ID = 8 を指定することによって呼び出されます。
構文
sp_cursoroption cursor , code , value
[ ; ]
引数
cursor
SQL Server によって生成され、sp_cursoropen ストアド プロシージャによって返されるhandle値。 cursor パラメーターは int であり、NULLすることはできません。
code
カーソル戻り値のさまざまな要因を指定するために使用されます。 code パラメーターは int で、次のいずれかの値である必要があります。
| Value | 名前 | 説明 |
|---|---|---|
0x0001 |
TEXTPTR_ONLY |
指定された特定の text 列または image 列の実際のデータではなくテキスト ポインターを返します。TEXTPTR_ONLYでは、後で Transact-SQL または DBLIB 機能 (Transact-SQL READTEXTや DBLIB DBWRITETEXT など) を使用して選択的に取得または更新できる BLOB オブジェクトに対して、テキスト ポインターをハンドルとして使用できます。0値が割り当てられている場合、選択リスト内のすべてのテキスト列と画像列は、データではなくテキスト ポインターを返します。 |
0x0002 |
CURSOR_NAME |
value で指定された名前をカーソルに割り当てます。これにより、ODBC は、sp_cursoropenを介して開かれたカーソルで Transact-SQL の位置指定されたUPDATE/DELETE ステートメントを使用できます。文字列は、任意の文字または Unicode データ型として指定できます。 Transact-SQL の位置指定 UPDATE/DELETE ステートメントは既定で fat カーソルの最初の行で動作するため、 sp_cursor SETPOSITION を使用して、位置指定された UPDATE/DELETE ステートメントを発行する前にカーソルを配置する必要があります。 |
0x0003 |
TEXTDATA |
後続のフェッチ時の特定のテキスト列または画像列に対して、テキスト ポインターではなく実際のデータを返します (つまり、 TEXTPTR_ONLYの影響を元に戻します)。特定の列に対して TEXTDATA が有効になっている場合、行は再フェッチまたは更新され、 TEXTPTR_ONLYに戻すことができます。 TEXTPTR_ONLYと同様に、value パラメーターは列番号を指定する整数であり、ゼロの値はすべてのテキスト列またはイメージ列を返します。 |
0x0004 |
SCROLLOPT |
スクロール オプションです。 詳細については、「 コード値を返す」を参照してください。 |
0x0005 |
CCOPT |
コンカレンシー制御オプション。 詳細については、「 コード値を返す」を参照してください。 |
0x0006 |
ROWCOUNT |
結果セット内の現在の行数。 注: 非同期作成が使用されている場合、 sp_cursoropenによって返される値以降、ROWCOUNTが変更されている可能性があります。 行数が不明な場合は、 -1 値が返されます。 |
value
codeによって返される値を指定します。 value は、 0x0001、 0x0002、または 0x0003 code 入力値を呼び出す必須のパラメーターです。
2のコード値は文字列データ型です。 その他の コード 値の入力または value によって返される値は intです。
リターン コードの値
value パラメーターは、次のいずれかのcode値を返します。
| 戻り値 | 説明 |
|---|---|
0x0004 |
SCROLLOPT |
0X0005 |
CCOPT |
0X0006 |
ROWCOUNT |
value パラメーターは、次のいずれかのSCROLLOPT値を返します。
| 戻り値 | 説明 |
|---|---|
0x0001 |
KEYSET |
0x0002 |
DYNAMIC |
0x0004 |
FORWARD_ONLY |
0x0008 |
STATIC |
value パラメーターは、次のいずれかのCCOPT値を返します。
| 戻り値 | 説明 |
|---|---|
0x0001 |
READ_ONLY |
0x0002 |
SCROLL_LOCKS |
0x0004 or 0x0008 |
OPTIMISTIC |