Compartilhar via


Mapeamento SQLGetConnectOption

Quando um aplicativo chama SQLGetConnectOption por meio de um driver ODBC 3.x , a chamada para

SQLGetConnectOption(hdbc, fOption, pvParam)   

é mapeado da seguinte maneira:

  • Se fOption indicar uma opção de conexão definida pelo ODBC que retorna uma cadeia de caracteres, o Gerenciador de Driver chamará

    SQLGetConnectAttr(ConnectionHandle, Attribute, ValuePtr, BufferLength, NULL)  
    
  • Se fOption indicar uma opção de conexão definida pelo ODBC que retorna um valor inteiro de 32 bits, o Gerenciador de Driver chamará

    SQLGetConnectAttr(ConnectionHandle, Attribute, ValuePtr, 0, NULL)  
    
  • Se fOption indicar uma opção de instrução definida pelo driver, o Gerenciador de Driver chamará

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

Nos três casos anteriores, o argumento ConnectionHandle é definido como o valor em hdbc, o argumento Attribute é definido como o valor em fOption e o argumento ValuePtr é definido como o mesmo valor que pvParam.

Para opções de conexão de cadeia de caracteres definidas pelo ODBC, o Gerenciador de Driver define o argumento BufferLength na chamada como SQLGetConnectAttr como o comprimento máximo predefinido (SQL_MAX_OPTION_STRING_LENGTH); para uma opção de conexão nãostring, BufferLength é definido como 0.

Para um driver ODBC 3.x , o Gerenciador de Driver não verifica mais se Option está entre SQL_CONN_OPT_MIN e SQL_CONN_OPT_MAX ou é maior que SQL_CONNECT_OPT_DRVR_START. O driver deve verificar a validade dos valores de opção.