Help Center

CODBCBase.GetEnvAttrmethod

Returns the current setting of an environment attribute.

DatabasesmethodCODBC.incdocumented

Syntax

FUNCTION GetEnvAttr (BYVAL Attribute AS SQLINTEGER, BYVAL ValuePtr AS SQLPOINTER, BYVAL BufferLength AS SQLINTEGER, BYVAL StringLength AS SQLINTEGER PTR) AS SQLRETURN

Parameters

NameDescription
AttributeAttribute to retrieve.
ValuePtrPointer to a buffer in which to return the current value of the attribute specified by Attribute.
BufferLengthIf ValuePtr points to a character string, this argument should be the length of ValuePtr. If ValuePtr is an integer, BufferLength is ignored. If the attribute value is not a character string, BufferLength is unused.
StringLengthA pointer to a buffer in which to return the total number of bytes (excluding the null-termination character) available to return in ValuePtr. If ValuePtr is a null pointer, no length is returned. If the attribute value is a character string and the number of bytes available to return is greater than or equal to BufferLength, the data in ValuePtr is truncated to BufferLength minus the length of a null-termination character and is null-terminated by the driver.

Return value

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_NO_DATA, SQL_ERROR, or SQL_INVALID_HANDLE.

Description

Returns the current setting of an environment attribute.

Reference

  • Include file CODBC.inc
  • Defined in AfxNova/COdbc.inc:187
  • Documented in Databases/ODBC Classes/CODBC Class.md
  • Topic: ODBC Classes