Controladores Unicode

Se um driver deve ser um driver Unicode ou um driver ANSI depende inteiramente da natureza da fonte de dados. Se a fonte de dados der suporte a dados Unicode, o driver deverá ser um driver Unicode. Se a fonte de dados só der suporte a dados ANSI, o driver deverá permanecer um driver ANSI.

Um driver Unicode deve exportar SQLConnectW para ser reconhecido como um driver Unicode pelo Gerenciador de Driver.

Um driver Unicode deve aceitar funções Unicode (com um sufixo de W) e armazenar dados Unicode. Ele também pode aceitar funções ANSI, mas não é necessário. (O Gerenciador de Driver não passa uma chamada de função ANSI com o sufixo A para o driver, mas converte-a em uma chamada de função ANSI sem o sufixo e, em seguida, passa-a para o driver.)

Um driver Unicode deve ser capaz de retornar conjuntos de resultados em Unicode ou ANSI, dependendo da associação do aplicativo. Se um aplicativo se associa a SQL_C_CHAR, o driver Unicode deve converter dados SQL_WCHAR em SQL_CHAR. O gerenciador de drivers mapeará SQL_C_WCHAR para SQL_C_CHAR para drivers ANSI, mas não faz nenhum mapeamento para drivers Unicode.

Observação

Ao determinar o tipo de driver, o Gerenciador de Driver chamará SQLSetConnectAttr e definirá o atributo SQL_ATTR_ANSI_APP no momento da conexão. Se o aplicativo estiver usando APIs ANSI, SQL_ATTR_ANSI_APP será definido como SQL_AA_TRUE e, se estiver usando o Unicode, ele será definido como um valor de SQL_AA_FALSE. Esse atributo é usado para que o driver possa exibir um comportamento diferente com base no tipo de aplicativo. O atributo não pode ser definido diretamente pelo aplicativo e não tem suporte do SQLGetConnectAttr. Se um driver exibir o mesmo comportamento para aplicativos ANSI e Unicode, ele deverá retornar SQL_ERROR para esse atributo. Se o driver retornar SQL_SUCCESS, o Gerenciador de Driver separará as conexões ANSI e Unicode quando o pool de conexões for usado.