設定參數值
若要設定參數的值，應用程式只會設定繫結至參數的變數值。 設定此值的時機並不重要，只要在執行陳述式之前設定即可。 應用程式可以在繫結變數之前或之後設定值，而且可以視需要多次變更值。 執行陳述式時，驅動程式只會擷取變數的目前值。 當備妥的陳述式執行多次時，這特別有用；應用程式會在每次執行陳述式時，設定部分或所有變數的新值。 如需此範例，請參閱本節稍早的備妥的執行。
如果長度/指標緩衝區已在對 SQLBindParameter 的呼叫中，則必須先設定為下列其中一個值，才能執行陳述式：
繫結變數中資料的位元組長度。 只有在變數是字元或二進位 (ValueType 為 SQL_C_CHAR 或 SQL_C_BINARY) 時，驅動程式才會檢查此長度。
SQL_NTS。 資料是以 Null 結尾的字串。
SQL_NULL_DATA。 資料值為 Null，而驅動程式會忽略繫結變數的值。
SQL_DATA_AT_EXEC 或 SQL_LEN_DATA_AT_EXEC 巨集的結果。 參數的值是使用 SQLPutData 傳送。 如需詳細資訊，請參閱本節稍後討論的傳送長資料。
下表顯示繫結變數的值，以及應用程式針對各種參數值所設定的長度/指標緩衝區。
| 參數 value |
參數 (SQL) 資料類型 |
變數 (C) 資料類型 |
中的值 繫結 變動 |
中的值 長度/指標 緩衝區[d] |
|---|---|---|---|---|
| "ABC" | SQL_CHAR | SQL_C_CHAR | ABC\0[a] | SQL_NTS 或 3 |
| 10 | SQL_INTEGER | SQL_C_SLONG | 10 | -- |
| 10 | SQL_INTEGER | SQL_C_CHAR | 10\0[a] | SQL_NTS 或 2 |
| 1 P.M. | SQL_TYPE_TIME | SQL_C_TYPE_TIME | 13,0,0[b] | -- |
| 1 P.M. | SQL_TYPE_TIME | SQL_C_CHAR | {t '13:00:00'}\0[a], [c] | SQL_NTS 或 14 |
| NULL | SQL_SMALLINT | SQL_C_SSHORT | -- | SQL_NULL_DATA |
[a] "\0" 代表 Null 終止字元。 只有在長度/指標緩衝區中的值為 SQL_NTS 時，才需要 Null 終止字元。
[b] 此清單中的數值是儲存在 TIME_STRUCT 結構的欄位中數值。
[c] 字串會使用 ODBC 日期逸出子句。 如需詳細資訊，請參閱日期、時間和時間戳記常值。
[d] 驅動程式必須一律檢查此值，以查看該值是否為特殊值，例如 SQL_Null_DATA。
驅動程式在執行階段使用參數值的功能與驅動程式相依。 如有必要，驅動程式會將繫結變數的 C 資料類型和位元組長度值轉換為參數 SQL 資料類型、有效位數和小數位數。 在大部分情況下，驅動程式接著會將值傳送至資料來源。 在某些情況下，驅動程式會將值格式化為文字，並將該文字插入 SQL 陳述式，再將陳述式傳送至資料來源。