Skip to content

Latest commit

 

History

History
26 lines (21 loc) · 1.45 KB

allocating-an-environment-handle.md

File metadata and controls

26 lines (21 loc) · 1.45 KB
title description author ms.author ms.date ms.service ms.subservice ms.topic helpviewer_keywords
Allocating an Environment Handle
Allocating an Environment Handle
markingmyname
maghan
03/16/2017
sql
native-client
reference
SQL Server Native Client ODBC driver, environment handles
ODBC applications, connections
handles [SQL Server Native Client]
environment handles [SQLNCLI]

Allocating an Environment Handle

[!INCLUDESQL Server Azure SQL Database Synapse Analytics PDW]

Before an application can call any ODBC function, it must initialize the ODBC environment and allocate an environment handle. This is the global context handle and placeholder for the other handles in ODBC. You do this by calling SQLAllocHandle with the HandleType parameter set to SQL_HANDLE_ENV and InputHandle set to SQL_NULL_HANDLE.

After allocating the environment handle, the application must set environment attributes to indicate which version of ODBC function calls it will be using. To use the ODBC 3.x functions, call SQLSetEnvAttr with the Attribute parameter set to SQL_ATTR_ODBC_VERSION and ValuePtr set to SQL_OV_ODBC3.

See Also

Communicating with SQL Server (ODBC)