適用対象:
SQL Server
カーソル オプションを設定するか、 sp_cursoropen ストアド プロシージャによって作成されたカーソル情報を返します。
sp_cursoroption は、表形式データ ストリーム (TDS) パケットで ID = 8 を指定することによって呼び出されます。
構文
sp_cursoroption cursor , code , value
[ ; ]
引数
大事な
拡張ストアド プロシージャの引数は、「構文の」セクションで説明されているように、特定の順序で入力する必要があります。 パラメーターが順に入力されていない場合は、エラー メッセージが表示されます。
cursor
SQL Server によって生成され、handle ストアド プロシージャによって返されるsp_cursoropen値。
cursor パラメーターは int であり、NULLすることはできません。
code
カーソル戻り値のさまざまな要因を指定するために使用されます。 code パラメーターは int で、次のいずれかの値である必要があります。
| Value | 名前 | 説明 |
|---|---|---|
0x0001 |
TEXTPTR_ONLY |
指定された特定の text 列または image 列の実際のデータではなくテキスト ポインターを返します。TEXTPTR_ONLYでは、後で Transact-SQL または DBLIB 機能 (Transact-SQL や DBLIBDBWRITETEXTハンドルとして使用できます。0値が割り当てられている場合、選択リスト内のすべてのテキスト列と画像列は、データではなくテキスト ポインターを返します。 |
0x0002 |
CURSOR_NAME |
value で指定された名前をカーソルに割り当てます。これにより、ODBC は、UPDATEを介して開かれたカーソルで Transact-SQL の位置指定された/DELETEsp_cursoropen ステートメントを使用できます。文字列は、任意の文字または 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 |
結果セット内の現在の行数。 注: 非同期作成が使用されている場合、 ROWCOUNTによって返される値以降、sp_cursoropenが変更されている可能性があります。 行数が不明な場合は、 -1 値が返されます。 |
value
codeによって返される値を指定します。
value は、 0x0001、 0x0002、または 0x0003code 入力値を呼び出す必須のパラメーターです。
の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 |