7.3. ODPI-C Structure dpiAppContext
This structure is used for passing application context to the database during
the process of creating standalone connections. These values are ignored when
acquiring a connection from a session pool or when using DRCP (Database
Resident Connection Pooling). All values must be set to valid values prior to
being used in the dpiConnCreateParams structure and
must remain valid until the execution of dpiConn_create()
completes.
Values set using this structure are available in logon triggers by using the
sys_context() SQL function.
-
const char *dpiAppContext.namespaceName
Specifies the value of the “namespace” parameter to sys_context(). It is expected to be a byte string in the encoding specified in the dpiConnCreateParams structure and must not be NULL.
-
uint32_t dpiAppContext.namespaceNameLength
Specifies the length of the
dpiAppContext.namespaceName
member, in bytes.
-
const char *dpiAppContext.name
Specifies the value of the “parameter” parameter to sys_context(). It is expected to be a byte string in the encoding specified in the dpiConnCreateParams structure and must not be NULL.
-
uint32_t dpiAppContext.nameLength
Specifies the length of the
dpiAppContext.name
member, in bytes.
-
const char *dpiAppContext.value
Specifies the value that will be returned from sys_context(). It is expected to be a byte string in the encoding specified in the dpiConnCreateParams structure and must not be NULL.
-
uint32_t dpiAppContext.valueLength
Specifies the length of the
dpiAppContext.value
member, in bytes.