oracledb 3.0.0 → 3.1.2

package/odpi/src/dpiEnqOptions.c

@@ -1,174 +0,0 @@
-//-----------------------------------------------------------------------------
-// Copyright (c) 2016, 2018, Oracle and/or its affiliates. All rights reserved.
-// This program is free software: you can modify it and/or redistribute it
-// under the terms of:
-//
-// (i)  the Universal Permissive License v 1.0 or at your option, any
-//      later version (http://oss.oracle.com/licenses/upl); and/or
-//
-// (ii) the Apache License v 2.0. (http://www.apache.org/licenses/LICENSE-2.0)
-//-----------------------------------------------------------------------------
-
-//-----------------------------------------------------------------------------
-// dpiEnqOptions.c
-//   Implementation of AQ enqueue options.
-//-----------------------------------------------------------------------------
-
-#include "dpiImpl.h"
-
-//-----------------------------------------------------------------------------
-// dpiEnqOptions__create() [INTERNAL]
-//   Create a new subscription structure and return it. In case of error NULL
-// is returned.
-//-----------------------------------------------------------------------------
-int dpiEnqOptions__create(dpiEnqOptions *options, dpiConn *conn,
-        dpiError *error)
-{
-    dpiGen__setRefCount(conn, error, 1);
-    options->conn = conn;
-    return dpiOci__descriptorAlloc(conn->env->handle, &options->handle,
-            DPI_OCI_DTYPE_AQENQ_OPTIONS, "allocate descriptor", error);
-}
-
-
-//-----------------------------------------------------------------------------
-// dpiEnqOptions__free() [INTERNAL]
-//   Free the memory for a enqueue options structure.
-//-----------------------------------------------------------------------------
-void dpiEnqOptions__free(dpiEnqOptions *options, dpiError *error)
-{
-    if (options->handle) {
-        dpiOci__descriptorFree(options->handle, DPI_OCI_DTYPE_AQENQ_OPTIONS);
-        options->handle = NULL;
-    }
-    if (options->conn) {
-        dpiGen__setRefCount(options->conn, error, -1);
-        options->conn = NULL;
-    }
-    dpiUtils__freeMemory(options);
-}
-
-
-//-----------------------------------------------------------------------------
-// dpiEnqOptions__getAttrValue() [INTERNAL]
-//   Get the attribute value in OCI.
-//-----------------------------------------------------------------------------
-static int dpiEnqOptions__getAttrValue(dpiEnqOptions *options,
-        uint32_t attribute, const char *fnName, void *value,
-        uint32_t *valueLength)
-{
-    dpiError error;
-    int status;
-
-    if (dpiGen__startPublicFn(options, DPI_HTYPE_ENQ_OPTIONS, fnName, 1,
-            &error) < 0)
-        return dpiGen__endPublicFn(options, DPI_FAILURE, &error);
-    DPI_CHECK_PTR_NOT_NULL(options, value)
-    DPI_CHECK_PTR_NOT_NULL(options, valueLength)
-    status = dpiOci__attrGet(options->handle, DPI_OCI_DTYPE_AQENQ_OPTIONS,
-            value, valueLength, attribute, "get attribute value", &error);
-    return dpiGen__endPublicFn(options, status, &error);
-}
-
-
-//-----------------------------------------------------------------------------
-// dpiEnqOptions__setAttrValue() [INTERNAL]
-//   Set the attribute value in OCI.
-//-----------------------------------------------------------------------------
-static int dpiEnqOptions__setAttrValue(dpiEnqOptions *options,
-        uint32_t attribute, const char *fnName, const void *value,
-        uint32_t valueLength)
-{
-    dpiError error;
-    int status;
-
-    if (dpiGen__startPublicFn(options, DPI_HTYPE_ENQ_OPTIONS, fnName, 1,
-            &error) < 0)
-        return dpiGen__endPublicFn(options, DPI_FAILURE, &error);
-    DPI_CHECK_PTR_NOT_NULL(options, value)
-    status = dpiOci__attrSet(options->handle, DPI_OCI_DTYPE_AQENQ_OPTIONS,
-            (void*) value, valueLength, attribute, "set attribute value",
-            &error);
-    return dpiGen__endPublicFn(options, status, &error);
-}
-
-
-//-----------------------------------------------------------------------------
-// dpiEnqOptions_addRef() [PUBLIC]
-//   Add a reference to the enqueue options.
-//-----------------------------------------------------------------------------
-int dpiEnqOptions_addRef(dpiEnqOptions *options)
-{
-    return dpiGen__addRef(options, DPI_HTYPE_ENQ_OPTIONS, __func__);
-}
-
-
-//-----------------------------------------------------------------------------
-// dpiEnqOptions_getTransformation() [PUBLIC]
-//   Return transformation associated with enqueue options.
-//-----------------------------------------------------------------------------
-int dpiEnqOptions_getTransformation(dpiEnqOptions *options, const char **value,
-        uint32_t *valueLength)
-{
-    return dpiEnqOptions__getAttrValue(options, DPI_OCI_ATTR_TRANSFORMATION,
-            __func__, (void*) value, valueLength);
-}
-
-
-//-----------------------------------------------------------------------------
-// dpiEnqOptions_getVisibility() [PUBLIC]
-//   Return visibility associated with enqueue options.
-//-----------------------------------------------------------------------------
-int dpiEnqOptions_getVisibility(dpiEnqOptions *options, dpiVisibility *value)
-{
-    uint32_t valueLength = sizeof(uint32_t);
-
-    return dpiEnqOptions__getAttrValue(options, DPI_OCI_ATTR_VISIBILITY,
-            __func__, value, &valueLength);
-}
-
-
-//-----------------------------------------------------------------------------
-// dpiEnqOptions_release() [PUBLIC]
-//   Release a reference to the enqueue options.
-//-----------------------------------------------------------------------------
-int dpiEnqOptions_release(dpiEnqOptions *options)
-{
-    return dpiGen__release(options, DPI_HTYPE_ENQ_OPTIONS, __func__);
-}
-
-
-//-----------------------------------------------------------------------------
-// dpiEnqOptions_setDeliveryMode() [PUBLIC]
-//   Set the delivery mode associated with enqueue options.
-//-----------------------------------------------------------------------------
-int dpiEnqOptions_setDeliveryMode(dpiEnqOptions *options,
-        dpiMessageDeliveryMode value)
-{
-    return dpiEnqOptions__setAttrValue(options, DPI_OCI_ATTR_MSG_DELIVERY_MODE,
-            __func__, &value, 0);
-}
-
-
-//-----------------------------------------------------------------------------
-// dpiEnqOptions_setTransformation() [PUBLIC]
-//   Set transformation associated with enqueue options.
-//-----------------------------------------------------------------------------
-int dpiEnqOptions_setTransformation(dpiEnqOptions *options, const char *value,
-        uint32_t valueLength)
-{
-    return dpiEnqOptions__setAttrValue(options, DPI_OCI_ATTR_TRANSFORMATION,
-            __func__,  value, valueLength);
-}
-
-
-//-----------------------------------------------------------------------------
-// dpiEnqOptions_setVisibility() [PUBLIC]
-//   Set visibility associated with enqueue options.
-//-----------------------------------------------------------------------------
-int dpiEnqOptions_setVisibility(dpiEnqOptions *options, dpiVisibility value)
-{
-    return dpiEnqOptions__setAttrValue(options, DPI_OCI_ATTR_VISIBILITY,
-            __func__, &value, 0);
-}
-

package/odpi/src/dpiEnv.c

@@ -1,189 +0,0 @@
-//-----------------------------------------------------------------------------
-// Copyright (c) 2016, 2018, Oracle and/or its affiliates. All rights reserved.
-// This program is free software: you can modify it and/or redistribute it
-// under the terms of:
-//
-// (i)  the Universal Permissive License v 1.0 or at your option, any
-//      later version (http://oss.oracle.com/licenses/upl); and/or
-//
-// (ii) the Apache License v 2.0. (http://www.apache.org/licenses/LICENSE-2.0)
-//-----------------------------------------------------------------------------
-
-//-----------------------------------------------------------------------------
-// dpiEnv.c
-//   Implementation of environment.
-//-----------------------------------------------------------------------------
-
-#include "dpiImpl.h"
-
-//-----------------------------------------------------------------------------
-// dpiEnv__free() [INTERNAL]
-//   Free the memory associated with the environment.
-//-----------------------------------------------------------------------------
-void dpiEnv__free(dpiEnv *env, dpiError *error)
-{
-    if (env->threaded)
-        dpiMutex__destroy(env->mutex);
-    if (env->handle) {
-        dpiOci__handleFree(env->handle, DPI_OCI_HTYPE_ENV);
-        env->handle = NULL;
-    }
-    if (env->errorHandles) {
-        dpiHandlePool__free(env->errorHandles);
-        env->errorHandles = NULL;
-        error->handle = NULL;
-    }
-    dpiUtils__freeMemory(env);
-}
-
-
-//-----------------------------------------------------------------------------
-// dpiEnv__getCharacterSetIdAndName() [INTERNAL]
-//   Retrieve and store the IANA character set name for the attribute.
-//-----------------------------------------------------------------------------
-static int dpiEnv__getCharacterSetIdAndName(dpiEnv *env, uint16_t attribute,
-        uint16_t *charsetId, char *encoding, dpiError *error)
-{
-    *charsetId = 0;
-    dpiOci__attrGet(env->handle, DPI_OCI_HTYPE_ENV, charsetId, NULL, attribute,
-            "get environment", error);
-    return dpiGlobal__lookupEncoding(*charsetId, encoding, error);
-}
-
-
-//-----------------------------------------------------------------------------
-// dpiEnv__getEncodingInfo() [INTERNAL]
-//   Populate the structure with the encoding info.
-//-----------------------------------------------------------------------------
-int dpiEnv__getEncodingInfo(dpiEnv *env, dpiEncodingInfo *info)
-{
-    info->encoding = env->encoding;
-    info->maxBytesPerCharacter = env->maxBytesPerCharacter;
-    info->nencoding = env->nencoding;
-    info->nmaxBytesPerCharacter = env->nmaxBytesPerCharacter;
-    return DPI_SUCCESS;
-}
-
-
-//-----------------------------------------------------------------------------
-// dpiEnv__init() [INTERNAL]
-//   Initialize the environment structure by creating the OCI environment and
-// populating information about the environment.
-//-----------------------------------------------------------------------------
-int dpiEnv__init(dpiEnv *env, const dpiContext *context,
-        const dpiCommonCreateParams *params, dpiError *error)
-{
-    char timezoneBuffer[20];
-    size_t timezoneLength;
-
-    // lookup encoding
-    if (params->encoding && dpiGlobal__lookupCharSet(params->encoding,
-            &env->charsetId, error) < 0)
-        return DPI_FAILURE;
-
-    // check for identical encoding before performing lookup
-    if (params->nencoding && params->encoding &&
-            strcmp(params->nencoding, params->encoding) == 0)
-        env->ncharsetId = env->charsetId;
-    else if (params->nencoding && dpiGlobal__lookupCharSet(params->nencoding,
-            &env->ncharsetId, error) < 0)
-        return DPI_FAILURE;
-
-    // both charsetId and ncharsetId must be zero or both must be non-zero
-    // use NLS routine to look up missing value, if needed
-    if (env->charsetId && !env->ncharsetId) {
-        if (dpiOci__nlsEnvironmentVariableGet(DPI_OCI_NLS_NCHARSET_ID,
-                &env->ncharsetId, error) < 0)
-            return DPI_FAILURE;
-    } else if (!env->charsetId && env->ncharsetId) {
-        if (dpiOci__nlsEnvironmentVariableGet(DPI_OCI_NLS_CHARSET_ID,
-                &env->charsetId, error) < 0)
-            return DPI_FAILURE;
-    }
-
-    // create the new environment handle
-    env->context = context;
-    env->versionInfo = context->versionInfo;
-    if (dpiOci__envNlsCreate(&env->handle, params->createMode | DPI_OCI_OBJECT,
-            env->charsetId, env->ncharsetId, error) < 0)
-        return DPI_FAILURE;
-
-    // create the error handle pool and acquire the first error handle
-    if (dpiHandlePool__create(&env->errorHandles, error) < 0)
-        return DPI_FAILURE;
-    if (dpiEnv__initError(env, error) < 0)
-        return DPI_FAILURE;
-
-    // if threaded, create mutex for reference counts
-    if (params->createMode & DPI_OCI_THREADED)
-        dpiMutex__initialize(env->mutex);
-
-    // determine encodings in use
-    if (dpiEnv__getCharacterSetIdAndName(env, DPI_OCI_ATTR_CHARSET_ID,
-            &env->charsetId, env->encoding, error) < 0)
-        return DPI_FAILURE;
-    if (dpiEnv__getCharacterSetIdAndName(env, DPI_OCI_ATTR_NCHARSET_ID,
-            &env->ncharsetId, env->nencoding, error) < 0)
-        return DPI_FAILURE;
-
-    // acquire max bytes per character
-    if (dpiOci__nlsNumericInfoGet(env->handle, &env->maxBytesPerCharacter,
-            DPI_OCI_NLS_CHARSET_MAXBYTESZ, error) < 0)
-        return DPI_FAILURE;
-
-    // for NCHAR we have no idea of how many so we simply take the worst case
-    // unless the charsets are identical
-    if (env->ncharsetId == env->charsetId)
-        env->nmaxBytesPerCharacter = env->maxBytesPerCharacter;
-    else env->nmaxBytesPerCharacter = 4;
-
-    // allocate base date descriptor (for converting to/from time_t)
-    if (dpiOci__descriptorAlloc(env->handle, &env->baseDate,
-            DPI_OCI_DTYPE_TIMESTAMP_LTZ, "alloc base date descriptor",
-            error) < 0)
-        return DPI_FAILURE;
-
-    // populate base date with January 1, 1970
-    if (dpiOci__nlsCharSetConvert(env->handle, env->charsetId, timezoneBuffer,
-            sizeof(timezoneBuffer), DPI_CHARSET_ID_ASCII, "+00:00", 6,
-            &timezoneLength, error) < 0)
-        return DPI_FAILURE;
-    if (dpiOci__dateTimeConstruct(env->handle, env->baseDate, 1970, 1, 1, 0, 0,
-            0, 0, timezoneBuffer, timezoneLength, error) < 0)
-        return DPI_FAILURE;
-
-    // set whether or not we are threaded
-    if (params->createMode & DPI_MODE_CREATE_THREADED)
-        env->threaded = 1;
-
-    // set whether or not events mode has been set
-    if (params->createMode & DPI_MODE_CREATE_EVENTS)
-        env->events = 1;
-
-    return DPI_SUCCESS;
-}
-
-
-//-----------------------------------------------------------------------------
-// dpiEnv__initError() [INTERNAL]
-//   Retrieve the OCI error handle to use for error handling, from a pool of
-// error handles common to the environment handle. The environment that was
-// used to create the error handle is stored in the error structure so that
-// the encoding and character set can be retrieved in the event of an OCI
-// error (which uses the CHAR encoding of the environment).
-//-----------------------------------------------------------------------------
-int dpiEnv__initError(dpiEnv *env, dpiError *error)
-{
-    error->env = env;
-    if (dpiHandlePool__acquire(env->errorHandles, &error->handle, error) < 0)
-        return DPI_FAILURE;
-
-    if (!error->handle) {
-        if (dpiOci__handleAlloc(env->handle, &error->handle,
-                DPI_OCI_HTYPE_ERROR, "allocate OCI error", error) < 0)
-            return DPI_FAILURE;
-    }
-
-    return DPI_SUCCESS;
-}
-

package/odpi/src/dpiError.c

@@ -1,204 +0,0 @@
-//-----------------------------------------------------------------------------
-// Copyright (c) 2016, 2018, Oracle and/or its affiliates. All rights reserved.
-// This program is free software: you can modify it and/or redistribute it
-// under the terms of:
-//
-// (i)  the Universal Permissive License v 1.0 or at your option, any
-//      later version (http://oss.oracle.com/licenses/upl); and/or
-//
-// (ii) the Apache License v 2.0. (http://www.apache.org/licenses/LICENSE-2.0)
-//-----------------------------------------------------------------------------
-
-//-----------------------------------------------------------------------------
-// dpiError.c
-//   Implementation of error.
-//-----------------------------------------------------------------------------
-
-#include "dpiImpl.h"
-#include "dpiErrorMessages.h"
-
-//-----------------------------------------------------------------------------
-// dpiError__check() [INTERNAL]
-//   Checks to see if the status of the last call resulted in an error
-// condition. If so, the error is populated. Note that trailing newlines and
-// spaces are truncated from the message if they exist. If the connection is
-// not NULL a check is made to see if the connection is no longer viable.
-//-----------------------------------------------------------------------------
-int dpiError__check(dpiError *error, int status, dpiConn *conn,
-        const char *action)
-{
-    uint32_t callTimeout;
-
-    // no error has taken place
-    if (status == DPI_OCI_SUCCESS || status == DPI_OCI_SUCCESS_WITH_INFO)
-        return DPI_SUCCESS;
-
-    // special error cases
-    if (status == DPI_OCI_INVALID_HANDLE)
-        return dpiError__set(error, action, DPI_ERR_INVALID_HANDLE, "OCI");
-    else if (!error)
-        return DPI_FAILURE;
-    else if (!error->handle)
-        return dpiError__set(error, action, DPI_ERR_ERR_NOT_INITIALIZED);
-    else if (status != DPI_OCI_ERROR && status != DPI_OCI_NO_DATA)
-        return dpiError__set(error, action,
-                DPI_ERR_UNEXPECTED_OCI_RETURN_VALUE, status,
-                error->buffer->fnName);
-
-    // fetch OCI error
-    error->buffer->action = action;
-    strcpy(error->buffer->encoding, error->env->encoding);
-    if (dpiOci__errorGet(error->handle, DPI_OCI_HTYPE_ERROR,
-            error->env->charsetId, action, error) < 0)
-        return DPI_FAILURE;
-    if (dpiDebugLevel & DPI_DEBUG_LEVEL_ERRORS)
-        dpiDebug__print("OCI error %.*s (%s / %s)\n",
-                error->buffer->messageLength, error->buffer->message,
-                error->buffer->fnName, action);
-
-    // determine if error is recoverable (Transaction Guard)
-    // if the attribute cannot be read properly, simply leave it as false;
-    // otherwise, that error will mask the one that we really want to see
-    error->buffer->isRecoverable = 0;
-    dpiOci__attrGet(error->handle, DPI_OCI_HTYPE_ERROR,
-            (void*) &error->buffer->isRecoverable, 0,
-            DPI_OCI_ATTR_ERROR_IS_RECOVERABLE, NULL, error);
-
-    // check for certain errors which indicate that the session is dead and
-    // should be dropped from the session pool (if a session pool was used)
-    // also check for call timeout and raise unified message instead
-    if (conn && !conn->deadSession) {
-        switch (error->buffer->code) {
-            case    22: // invalid session ID; access denied
-            case    28: // your session has been killed
-            case    31: // your session has been marked for kill
-            case    45: // your session has been terminated with no replay
-            case   378: // buffer pools cannot be created as specified
-            case   602: // internal programming exception
-            case   603: // ORACLE server session terminated by fatal error
-            case   609: // could not attach to incoming connection
-            case  1012: // not logged on
-            case  1041: // internal error. hostdef extension doesn't exist
-            case  1043: // user side memory corruption
-            case  1089: // immediate shutdown or close in progress
-            case  1092: // ORACLE instance terminated. Disconnection forced
-            case  2396: // exceeded maximum idle time, please connect again
-            case  3113: // end-of-file on communication channel
-            case  3114: // not connected to ORACLE
-            case  3122: // attempt to close ORACLE-side window on user side
-            case  3135: // connection lost contact
-            case 12153: // TNS:not connected
-            case 12537: // TNS:connection closed
-            case 12547: // TNS:lost contact
-            case 12570: // TNS:packet reader failure
-            case 12583: // TNS:no reader
-            case 27146: // post/wait initialization failed
-            case 28511: // lost RPC connection
-            case 56600: // an illegal OCI function call was issued
-                conn->deadSession = 1;
-                break;
-            case  3136: // inbound connection timed out
-            case 12161: // TNS:internal error: partial data received
-                callTimeout = 0;
-                if (conn->env->versionInfo->versionNum >= 18)
-                    dpiOci__attrGet(conn->handle, DPI_OCI_HTYPE_SVCCTX,
-                            (void*) &callTimeout, 0, DPI_OCI_ATTR_CALL_TIMEOUT,
-                            NULL, error);
-                if (callTimeout > 0) {
-                    dpiError__set(error, action, DPI_ERR_CALL_TIMEOUT,
-                            callTimeout, error->buffer->code);
-                    error->buffer->code = 0;
-                }
-                break;
-        }
-    }
-
-    return DPI_FAILURE;
-}
-
-
-//-----------------------------------------------------------------------------
-// dpiError__getInfo() [INTERNAL]
-//   Get the error state from the error structure. Returns DPI_FAILURE as a
-// convenience to the caller.
-//-----------------------------------------------------------------------------
-int dpiError__getInfo(dpiError *error, dpiErrorInfo *info)
-{
-    if (!info)
-        return DPI_FAILURE;
-    info->code = error->buffer->code;
-    info->offset = error->buffer->offset;
-    info->message = error->buffer->message;
-    info->messageLength = error->buffer->messageLength;
-    info->fnName = error->buffer->fnName;
-    info->action = error->buffer->action;
-    info->isRecoverable = error->buffer->isRecoverable;
-    info->encoding = error->buffer->encoding;
-    switch(info->code) {
-        case 12154: // TNS:could not resolve the connect identifier specified
-            info->sqlState = "42S02";
-            break;
-        case    22: // invalid session ID; access denied
-        case   378: // buffer pools cannot be created as specified
-        case   602: // Internal programming exception
-        case   603: // ORACLE server session terminated by fatal error
-        case   604: // error occurred at recursive SQL level
-        case   609: // could not attach to incoming connection
-        case  1012: // not logged on
-        case  1033: // ORACLE initialization or shutdown in progress
-        case  1041: // internal error. hostdef extension doesn't exist
-        case  1043: // user side memory corruption
-        case  1089: // immediate shutdown or close in progress
-        case  1090: // shutdown in progress
-        case  1092: // ORACLE instance terminated. Disconnection forced
-        case  3113: // end-of-file on communication channel
-        case  3114: // not connected to ORACLE
-        case  3122: // attempt to close ORACLE-side window on user side
-        case  3135: // connection lost contact
-        case 12153: // TNS:not connected
-        case 27146: // post/wait initialization failed
-        case 28511: // lost RPC connection to heterogeneous remote agent
-            info->sqlState = "01002";
-            break;
-        default:
-            if (error->buffer->code == 0 &&
-                    error->buffer->errorNum == (dpiErrorNum) 0)
-                info->sqlState = "00000";
-            else info->sqlState = "HY000";
-            break;
-    }
-    return DPI_FAILURE;
-}
-
-
-//-----------------------------------------------------------------------------
-// dpiError__set() [INTERNAL]
-//   Set the error buffer to the specified DPI error. Returns DPI_FAILURE as a
-// convenience to the caller.
-//-----------------------------------------------------------------------------
-int dpiError__set(dpiError *error, const char *action, dpiErrorNum errorNum,
-        ...)
-{
-    va_list varArgs;
-
-    if (error) {
-        error->buffer->code = 0;
-        error->buffer->isRecoverable = 0;
-        error->buffer->offset = 0;
-        strcpy(error->buffer->encoding, DPI_CHARSET_NAME_UTF8);
-        error->buffer->action = action;
-        error->buffer->errorNum = errorNum;
-        va_start(varArgs, errorNum);
-        error->buffer->messageLength =
-                (uint32_t) vsnprintf(error->buffer->message,
-                sizeof(error->buffer->message),
-                dpiErrorMessages[errorNum - DPI_ERR_NO_ERR], varArgs);
-        va_end(varArgs);
-        if (dpiDebugLevel & DPI_DEBUG_LEVEL_ERRORS)
-            dpiDebug__print("internal error %.*s (%s / %s)\n",
-                    error->buffer->messageLength, error->buffer->message,
-                    error->buffer->fnName, action);
-    }
-    return DPI_FAILURE;
-}
-

package/odpi/src/dpiErrorMessages.h

@@ -1,86 +0,0 @@
-//-----------------------------------------------------------------------------
-// Copyright (c) 2016, 2018, Oracle and/or its affiliates. All rights reserved.
-// This program is free software: you can modify it and/or redistribute it
-// under the terms of:
-//
-// (i)  the Universal Permissive License v 1.0 or at your option, any
-//      later version (http://oss.oracle.com/licenses/upl); and/or
-//
-// (ii) the Apache License v 2.0. (http://www.apache.org/licenses/LICENSE-2.0)
-//-----------------------------------------------------------------------------
-
-//-----------------------------------------------------------------------------
-// dpiErrorMessages.h
-//   Definition of error messages used in ODPI-C.
-//-----------------------------------------------------------------------------
-
-#include "dpiImpl.h"
-
-static const char* const dpiErrorMessages[DPI_ERR_MAX - DPI_ERR_NO_ERR] = {
-    "DPI-1000: no error", // DPI_ERR_NO_ERR
-    "DPI-1001: out of memory", // DPI_ERR_NO_MEMORY
-    "DPI-1002: invalid %s handle", // DPI_ERR_INVALID_HANDLE
-    "DPI-1003: OCI error handle is not initialized", // DPI_ERR_ERR_NOT_INITIALIZED
-    "DPI-1004: unable to get error message", // DPI_ERR_GET_FAILED
-    "DPI-1005: unable to acquire Oracle environment handle", // DPI_ERR_CREATE_ENV
-    "DPI-1006: unable to convert text to session character set", // DPI_ERR_CONVERT_TEXT
-    "DPI-1007: no query has been executed", // DPI_ERR_QUERY_NOT_EXECUTED
-    "DPI-1008: data type %d is not supported", // DPI_ERR_UNHANDLED_DATA_TYPE
-    "DPI-1009: zero-based position %u is not valid with max array size of %u", // DPI_ERR_INVALID_ARRAY_POSITION
-    "DPI-1010: not connected", // DPI_ERR_NOT_CONNECTED
-    "DPI-1011: connection was not acquired from a session pool", // DPI_ERR_CONN_NOT_IN_POOL
-    "DPI-1012: proxy authentication is not possible with homogeneous pools", // DPI_ERR_INVALID_PROXY
-    "DPI-1013: not supported", // DPI_ERR_NOT_SUPPORTED
-    "DPI-1014: conversion between Oracle type %d and native type %d is not implemented", // DPI_ERR_UNHANDLED_CONVERSION
-    "DPI-1015: array size of %u is too large", // DPI_ERR_ARRAY_SIZE_TOO_BIG
-    "DPI-1016: invalid date", // DPI_ERR_INVALID_DATE
-    "DPI-1017: value is null", // DPI_ERR_VALUE_IS_NULL
-    "DPI-1018: array size of %u is too small", // DPI_ERR_ARRAY_SIZE_TOO_SMALL
-    "DPI-1019: buffer size of %u is too small", // DPI_ERR_BUFFER_SIZE_TOO_SMALL
-    "DPI-1020: version %d.%d is not supported by ODPI-C library version %d.%d", // DPI_ERR_VERSION_NOT_SUPPORTED
-    "DPI-1021: Oracle type %u is invalid", // DPI_ERR_INVALID_ORACLE_TYPE
-    "DPI-1022: attribute %.*s is not part of object type %.*s.%.*s", // DPI_ERR_WRONG_ATTR
-    "DPI-1023: object %.*s.%.*s is not a collection", // DPI_ERR_NOT_COLLECTION
-    "DPI-1024: element at index %d does not exist", // DPI_ERR_INVALID_INDEX
-    "DPI-1025: no object type specified for object variable", // DPI_ERR_NO_OBJECT_TYPE
-    "DPI-1026: invalid character set %s", // DPI_ERR_INVALID_CHARSET
-    "DPI-1027: scroll operation would go out of the result set", // DPI_ERR_SCROLL_OUT_OF_RS
-    "DPI-1028: query position %u is invalid", // DPI_ERR_QUERY_POSITION_INVALID
-    "DPI-1029: no row currently fetched", // DPI_ERR_NO_ROW_FETCHED
-    "DPI-1030: unable to get or set error structure for thread local storage", // DPI_ERR_TLS_ERROR
-    "DPI-1031: array size cannot be zero", // DPI_ERR_ARRAY_SIZE_ZERO
-    "DPI-1032: user name and password cannot be set when using external authentication", // DPI_ERR_EXT_AUTH_WITH_CREDENTIALS
-    "DPI-1033: unable to get row offset", // DPI_ERR_CANNOT_GET_ROW_OFFSET
-    "DPI-1034: connection created from external handle cannot be closed", // DPI_ERR_CONN_IS_EXTERNAL
-    "DPI-1035: size of the transaction ID is %u and cannot exceed %u", // DPI_ERR_TRANS_ID_TOO_LARGE
-    "DPI-1036: size of the branch ID is %u and cannot exceed %u", // DPI_ERR_BRANCH_ID_TOO_LARGE
-    "DPI-1037: column at array position %u fetched with error %u", // DPI_ERR_COLUMN_FETCH
-    "DPI-1039: statement was already closed", // DPI_ERR_STMT_CLOSED
-    "DPI-1040: LOB was already closed", // DPI_ERR_LOB_CLOSED
-    "DPI-1041: invalid character set id %d", // DPI_ERR_INVALID_CHARSET_ID
-    "DPI-1042: invalid OCI number", // DPI_ERR_INVALID_OCI_NUMBER
-    "DPI-1043: invalid number", // DPI_ERR_INVALID_NUMBER
-    "DPI-1044: number too large", // DPI_ERR_NUMBER_TOO_LARGE
-    "DPI-1045: strings converted to numbers can only be up to 172 characters long", // DPI_ERR_NUMBER_STRING_TOO_LONG
-    "DPI-1046: parameter %s cannot be a NULL pointer", // DPI_ERR_NULL_POINTER_PARAMETER
-    "DPI-1047: %s-bit Oracle Client library cannot be loaded: \"%s\". See https://oracle.github.io/odpi/doc/installation.html#%s for help", // DPI_ERR_LOAD_LIBRARY
-    "DPI-1049: symbol %s not found in OCI library", // DPI_ERR_LOAD_SYMBOL
-    "DPI-1050: Oracle Client library is at version %d.%d but must be at version %d.%d or higher", // DPI_ERR_ORACLE_CLIENT_TOO_OLD
-    "DPI-1052: unable to get NLS environment variable", // DPI_ERR_NLS_ENV_VAR_GET,
-    "DPI-1053: parameter %s cannot be a NULL pointer while corresponding length parameter is non-zero", // DPI_ERR_PTR_LENGTH_MISMATCH
-    "DPI-1055: value is not a number (NaN) and cannot be used in Oracle numbers", // DPI_ERR_NAN
-    "DPI-1056: found object of type %.*s.%.*s when expecting object of type %.*s.%.*s", // DPI_ERR_WRONG_TYPE
-    "DPI-1057: buffer size of %u is too large (max %u)", // DPI_ERR_BUFFER_SIZE_TOO_LARGE
-    "DPI-1058: edition not supported with connection class", // DPI_ERR_NO_EDITION_WITH_CONN_CLASS
-    "DPI-1059: bind variables are not supported in DDL statements", // DPI_ERR_NO_BIND_VARS_IN_DDL
-    "DPI-1060: subscription was already closed", // DPI_ERR_SUBSCR_CLOSED
-    "DPI-1061: edition is not supported when a new password is specified", // DPI_ERR_NO_EDITION_WITH_NEW_PASSWORD
-    "DPI-1062: unexpected OCI return value %d in function %s", // DPI_ERR_UNEXPECTED_OCI_RETURN_VALUE
-    "DPI-1063: modes DPI_MODE_EXEC_BATCH_ERRORS and DPI_MODE_EXEC_ARRAY_DML_ROWCOUNTS can only be used with insert, update, delete and merge statements", // DPI_ERR_EXEC_MODE_ONLY_FOR_DML
-    "DPI-1064: array variables are not supported with dpiStmt_executeMany()", // DPI_ERR_ARRAY_VAR_NOT_SUPPORTED
-    "DPI-1065: events mode is required to subscribe to events in the database", // DPI_ERR_EVENTS_MODE_REQUIRED
-    "DPI-1066: Oracle Database is at version %d.%d but must be at version %d.%d or higher", // DPI_ERR_ORACLE_DB_TOO_OLD
-    "DPI-1067: call timeout of %u ms exceeded with ORA-%d", // DPI_ERR_CALL_TIMEOUT
-    "DPI-1068: SODA cursor was already closed", // DPI_ERR_SODA_CURSOR_CLOSED
-};
-