Freigeben über

SQLValidDSN-Funktion

  • Artikel

Konformität
Version eingeführt: ODBC 2.0

Zusammenfassung
SQLValidDSN überprüft die Länge und Gültigkeit des Datenquellennamens, bevor der Name den Systeminformationen hinzugefügt wird.

Syntax

  
BOOL SQLValidDSN(  
     LPCSTR    lpszDSN);

Argumente

lpszDSN
[Eingabe] Zu überprüfende Datenquellenname.

Gibt zurück

Die Funktion gibt TRUE zurück, wenn der Datenquellenname gültig ist. Es gibt FALSE zurück, wenn der Datenquellenname ungültig ist oder der Funktionsaufruf fehlgeschlagen ist.

Diagnose

Wenn SQLValidDSN FALSE zurückgibt, kann ein zugeordneter *pfErrorCode-Wert abgerufen werden, indem SQLInstallerError aufgerufen wird. Ein *pfErrorCode wird nur zurückgegeben, wenn der Funktionsaufruf fehlgeschlagen ist, nicht, wenn FALSE zurückgegeben wurde, da der Datenquellenname ungültig ist. In der folgenden Tabelle sind die *pfErrorCode-Werte aufgeführt, die von SQLInstallerError zurückgegeben werden können, und die einzelnen Werte im Kontext dieser Funktion werden erläutert.

*pfErrorCode Fehler BESCHREIBUNG
ODBC_ERROR_GENERAL_ERR Allgemeiner Installationsfehler Es ist ein Fehler aufgetreten, für den kein spezifischer Installerfehler aufgetreten ist.
ODBC_ERROR_OUT_OF_MEM Nicht genügend Arbeitsspeicher. Das Installationsprogramm konnte die Funktion aufgrund eines Mangels an Arbeitsspeicher nicht ausführen.

Kommentare

SQLValidDSN wird vom ConfigDSN eines Treibers aufgerufen, um die Länge des Datenquellennamens und die Gültigkeit der einzelnen Zeichen im Datenquellennamen zu überprüfen. Es überprüft, ob die Länge des Namens größer als SQL_MAX_DSN_LENGTH ist, wie in Sqlext.h definiert. (Die Länge des Datenquellennamens wird auch von SQLWriteDSNToIni überprüft.) SQLValidDSN überprüft, ob eines der folgenden ungültigen Zeichen im Namen der Datenquelle enthalten ist:

[ ] { } ( ) , ; ? * = ! @ \

Informationen über Finden Sie unter
Hinzufügen, Ändern oder Entfernen einer Datenquelle ConfigDSN (in der Setup-DLL)
Hinzufügen, Ändern oder Entfernen einer Datenquelle SQLConfigDataSource
Schreiben eines Datenquellennamens in die Systeminformationen SQLWriteDSNToIni