Compartilhar via


Identificadores de ambiente

Um ambiente é um contexto global no qual acessar dados; associado a um ambiente é qualquer informação de natureza global, como:

  • O estado do ambiente

  • O diagnóstico no nível do ambiente atual

  • Os identificadores de conexões atualmente alocados no ambiente

  • As configurações atuais de cada atributo de ambiente

Dentro de um código que implementa o ODBC (Gerenciador de Driver ou um driver), um identificador de ambiente identifica uma estrutura para conter essas informações.

Identificadores de ambiente não são usados com frequência em aplicativos ODBC. Eles são sempre usados em chamadas para SQLDataSources e SQLDrivers e, às vezes, usados em chamadas para SQLAllocHandle, SQLEndTran, SQLFreeHandle, SQLGetDiagField e SQLGetDiagRec.

Cada parte do código que implementa o ODBC (o Gerenciador de Driver ou um driver) contém um ou mais handles de ambiente. Por exemplo, o Gerenciador de Driver mantém um identificador de ambiente separado para cada aplicativo conectado a ele. Os identificadores de ambiente são alocados com SQLAllocHandle e liberados com SQLFreeHandle.