Controlli del valore dell'argomento

  • Articolo

Gestione driver controlla i tipi di argomenti seguenti. Se non diversamente specificato, Gestione driver restituisce SQL_ERROR per gli errori nei valori degli argomenti.

  • Gli handle di ambiente, connessione e istruzione in genere non possono essere puntatori Null. Gestione driver restituisce SQL_INVALID_HANDLE quando trova un handle Null.

  • Gli argomenti del puntatore obbligatori, come OutputHandlePtr in SQLAllocHandle e CursorName in SQLSetCursorName, non possono essere puntatori Null.

  • I flag di opzione che non supportano valori specifici del driver devono essere un valore legale. Ad esempio, l’operazione in SQLSetPos deve essere SQL_POSITION, SQL_REFRESH, SQL_UPDATE, SQL_DELETE o SQL_ADD.

  • I flag di opzione devono essere supportati nella versione di ODBC supportata dal driver. Ad esempio, InfoType in SQLGetInfo non può essere SQL_ASYNC_MODE (introdotto in ODBC 3.0) quando si chiama un driver ODBC 2.0.

  • I numeri di colonna e di parametro devono essere maggiori di 0, o maggiori o uguali a 0, a seconda della funzione. Il driver deve controllare il limite superiore di questi valori di argomento in base al set di risultati o all'istruzione SQL corrente.

  • Gli argomenti lunghezza/indicatore e gli argomenti relativi alla lunghezza del buffer dei dati devono contenere valori appropriati. Ad esempio, l'argomento che specifica la lunghezza di un nome tabella in SQLColumns (NameLength3) deve essere SQL_NTS o un valore maggiore di 0; BufferLength in SQLDescribeCol deve essere maggiore o uguale a 0. Il driver potrebbe dover controllare anche questi argomenti. Ad esempio, potrebbe verificare che NameLength3 sia minore o uguale alla lunghezza massima di un nome tabella dell'origine dati.