Partager via

SQLGetConnectOption, mappage

  • Article

Lorsqu’une application appelle SQLGetConnectOption via un pilote ODBC 3.x , l’appel à

SQLGetConnectOption(hdbc, fOption, pvParam)

est mappé comme suit :

  • Si fOption indique une option de connexion définie par ODBC qui retourne une chaîne, le Gestionnaire de pilotes appelle

    SQLGetConnectAttr(ConnectionHandle, Attribute, ValuePtr, BufferLength, NULL)

  • Si fOption indique une option de connexion définie par ODBC qui retourne une valeur entière 32 bits, le Gestionnaire de pilotes appelle

    SQLGetConnectAttr(ConnectionHandle, Attribute, ValuePtr, 0, NULL)

  • Si fOption indique une option d’instruction définie par le pilote, le Gestionnaire de pilotes appelle

    SQLGetConnectAttr(ConnectionHandle, Attribute, ValuePtr, BufferLength, NULL)

Dans les trois cas précédents, l’argument ConnectionHandle est défini sur la valeur dans hdbc, l’argument Attribute est défini sur la valeur dans fOption et l’argument ValuePtr est défini sur la même valeur que pvParam.

Pour les options de connexion de chaîne définies par ODBC, le Gestionnaire de pilotes définit l’argument BufferLength dans l’appel à SQLGetConnectAttr sur la longueur maximale prédéfinie (SQL_MAX_OPTION_STRING_LENGTH) ; pour une option de connexion non chaîne, BufferLength est défini sur 0.

Pour un pilote ODBC 3.x , le Gestionnaire de pilotes ne vérifie plus si Option se trouve entre SQL_CONN_OPT_MIN et SQL_CONN_OPT_MAX, ou s’il est supérieur à SQL_CONNECT_OPT_DRVR_START. Le pilote doit vérifier la validité des valeurs d’option.