SQLFreeEnv ​

功能描述 ​

用于释放环境句柄，其功能可被SQLFreeHandle函数替代。

原型 ​

SQLRETURN SQLFreeEnv(SQLHENV     EnvironmentHandle);

参数 ​

表 1 SQLFreeEnv参数

返回值 ​

• SQL_SUCCESS：表示调用正确。
• SQL_SUCCESS_WITH_INFO：表示会有一些警告信息。
• SQL_ERROR：执行失败，环境句柄未被释放。
• SQL_INVALID_HANDLE：表示传入的环境句柄无效。

注意事项 ​

如果SQLFreeEnv返回SQL_ERROR，环境句柄仍然有效。为了使得代码更健壮并易于维护，建议使用标准化接口SQLFreeHandle替代SQLFreeEnv。

示例 ​

参见：示例