Festlegen von Parameterwerten
Um den Wert eines Parameters festzulegen, legt die Anwendung einfach den Wert der Variablen fest, die an den Parameter gebunden ist. Es ist nicht wichtig, wenn dieser Wert festgelegt wird, solange er vor der Ausführung der Anweisung festgelegt wird. Die Anwendung kann den Wert vor oder nach der Bindung der Variablen festlegen und den Wert beliebig oft ändern. Wenn die Anweisung ausgeführt wird, ruft der Treiber einfach den aktuellen Wert der Variablen ab. Dies ist besonders nützlich, wenn eine vorbereitete Anweisung mehrmals ausgeführt wird; die Anwendung legt bei jeder Ausführung der Anweisung neue Werte für einige oder alle Variablen fest. Ein Beispiel hierfür finden Sie weiter oben in diesem Abschnitt unter "Vorbereitete Ausführung".
Wenn ein Längen-/Indikatorpuffer im Aufruf von SQLBindParameter gebunden wurde, muss er auf einen der folgenden Werte festgelegt werden, bevor die Anweisung ausgeführt wird:
Die Bytelänge der Daten in der gebundenen Variablen. Der Treiber überprüft diese Länge nur, wenn die Variable Zeichen oder Binärwerte ist (ValueType ist SQL_C_CHAR oder SQL_C_BINARY).
SQL_NTS. Die Daten sind eine mit Null beendete Zeichenfolge.
SQL_NULL_DATA. Der Datenwert ist NULL, und der Treiber ignoriert den Wert der gebundenen Variablen.
SQL_DATA_AT_EXEC oder das Ergebnis des SQL_LEN_DATA_AT_EXEC Makros. Der Wert des Parameters wird mit SQLPutData gesendet. Weitere Informationen finden Sie unter Senden langer Daten weiter unten in diesem Abschnitt.
Die folgende Tabelle enthält die Werte der gebundenen Variablen und den Längen-/Indikatorpuffer, den die Anwendung für eine Vielzahl von Parameterwerten festlegt.
| Parameter value |
Parameter (SQL) Datentyp |
Variable (C) Datentyp |
Wert in Begrenzung -Variable |
Wert in Länge/Indikator buffer[d] |
|---|---|---|---|---|
| "ABC" | SQL_CHAR | SQL_C_CHAR | ABC\0[a] | SQL_NTS oder 3 |
| 10 | SQL_INTEGER | SQL_C_SLONG | 10 | -- |
| 10 | SQL_INTEGER | SQL_C_CHAR | 10\0[a] | SQL_NTS oder 2 |
| 1.00 Uhr | SQL_TYPE_TIME | SQL_C_TYPE_TIME | 13,0,0[b] | -- |
| 1.00 Uhr | SQL_TYPE_TIME | SQL_C_CHAR | {t '13:00:00'}\0[a], [c] | SQL_NTS oder 14 |
| NULL | SQL_SMALLINT | SQL_C_SSHORT | -- | SQL_NULL_DATA |
[a] "\0" stellt ein Null-Beendigungszeichen dar. Das Nullendpunktzeichen ist nur erforderlich, wenn der Wert im Längen-/Indikatorpuffer SQL_NTS ist.
[b] Die Zahlen in dieser Liste sind die Zahlen, die in den Feldern der TIME_STRUCT Struktur gespeichert sind.
[c] Die Zeichenfolge verwendet die ODBC-Datums-Escapeklausel. Weitere Informationen finden Sie unter Datums-, Uhrzeit- und Zeitstempelliteralen.
[d] Treiber müssen diesen Wert immer überprüfen, um festzustellen, ob es sich um einen speziellen Wert handelt, z. B. SQL_NULL_DATA.
Die Funktionsweise eines Treibers mit einem Parameterwert zur Ausführungszeit ist treiberabhängig. Bei Bedarf konvertiert der Treiber den Wert aus dem C-Datentyp und die Bytelänge der gebundenen Variablen in den SQL-Datentyp, die Genauigkeit und den Maßstab des Parameters. In den meisten Fällen sendet der Treiber dann den Wert an die Datenquelle. In einigen Fällen wird der Wert als Text formatiert und in die SQL-Anweisung eingefügt, bevor die Anweisung an die Datenquelle gesendet wird.