.. _dpiConnInfo:
ODPI-C Structure dpiConnInfo
----------------------------
This structure is used for passing information about a connection from ODPI-C.
It is used by the function :func:`dpiConn_getInfo()`.
.. member:: const char* dpiConnInfo.dbDomain
A pointer to the name of the Oracle Database Domain name associated with
the connection, encoded in the encoding used for CHAR data. This is the
same value returned by the SQL expression
``SELECT VALUE FROM V$PARAMETER WHERE NAME = 'db_domain'``.
.. member:: uint32_t dpiConnInfo.dbDomainLength
Contains the length of the :member:`dpiConnInfo.dbDomain` member, in bytes.
.. member:: const char* dpiConnInfo.dbName
A pointer to the Oracle Database name associated with the connection,
encoded in the encoding used for CHAR data. This is the same value returned
by the SQL expression ``SELECT NAME FROM V$DATABASE``.
.. member:: uint32_t dpiConnInfo.dbNameLength
Contains the length of the :member:`dpiConnInfo.dbName` member, in bytes.
.. member:: const char* dpiConnInfo.instanceName
A pointer to the Oracle Database instance name associated with the
connection, encoded in the encoding used for CHAR data. This is the same
value returned by the SQL expression
``SELECT SYS_CONTEXT('USERENV', 'INSTANCE_NAME') FROM DUAL``.
.. member:: uint32_t dpiConnInfo.instanceNameLength
Contains the length of the :member:`dpiConnInfo.instanceName` member, in
bytes.
.. member:: const char* dpiConnInfo.serviceName
A pointer to the Oracle Database service name associated with the
connection, encoded in the encoding used for CHAR data. This is the same
value returned by the SQL expression
``SELECT SYS_CONTEXT('USERENV', 'SERVICE_NAME') FROM DUAL``.
.. member:: uint32_t dpiConnInfo.serviceNameLength
Contains the length of the :member:`dpiConnInfo.serviceName` member, in
bytes.
.. member:: uint32_t dpiConnInfo.maxIdentifierLength
Specifies the maximum length of identifiers (in bytes) supported by the
database to which the connection has been established. See
`Database Object Naming Rules <https://www.oracle.com/pls/topic/lookup
?ctx=dblatest&id=GUID-75337742-67FD-4EC0-985F-741C93D918DA>`__.
.. member:: uint32_t dpiConnInfo.maxOpenCursors
Specifies the maximum number of cursors that can be opened. This is the
same value returned by the SQL expression
``SELECT VALUE FROM V$PARAMETER WHERE NAME = 'open_cursors'``.
.. member:: uint8_t dpiConnInfo.serverType
Specifies the type of server process used by the connection. This value
will be one of the values in the enumeration
:ref:`dpiServerType <dpiServerType>`.