oracle 0.6.3

Oracle binding
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59

.. _dpiObjectAttrFunctions:

ODPI-C Object Attribute Functions
---------------------------------

Object attribute handles are used to represent the attributes of types such as
those created by the SQL command CREATE OR REPLACE TYPE. They are created by
calling the function :func:`dpiObjectType_getAttributes()` and are destroyed
when the last reference is released by calling the function
:func:`dpiObjectAttr_release()`.

.. function:: int dpiObjectAttr_addRef(dpiObjectAttr* attr)

    Adds a reference to the attribute. This is intended for situations where a
    reference to the attribute needs to be maintained independently of the
    reference returned when the attribute was created.

    The function returns DPI_SUCCESS for success and DPI_FAILURE for failure.

    .. parameters-table::

        * - ``attr``
          - IN
          - The attribute to which a reference is to be added. If the
            reference is NULL or invalid, an error is returned.

.. function:: int dpiObjectAttr_getInfo(dpiObjectAttr* attr, \
        dpiObjectAttrInfo* info)

    Returns information about the attribute.

    The function returns DPI_SUCCESS for success and DPI_FAILURE for failure.

    .. parameters-table::

        * - ``attr``
          - IN
          - A reference to the attribute whose information is to be retrieved.
            If the reference is NULL or invalid, an error is returned.
        * - ``info``
          - OUT
          - A pointer to a :ref:`dpiObjectAttrInfo<dpiObjectAttrInfo>`
            structure which will be populated with information about the
            attribute.

.. function:: int dpiObjectAttr_release(dpiObjectAttr* attr)

    Releases a reference to the attribute. A count of the references to the
    attribute is maintained and when this count reaches zero, the memory
    associated with the attribute is freed.

    The function returns DPI_SUCCESS for success and DPI_FAILURE for failure.

    .. parameters-table::

        * - ``attr``
          - IN
          - The attribute from which a reference is to be released. If the
            reference is NULL or invalid, an error is returned.