Share this page

# lrd_handle_alloc

Explicitly allocates and initializes an LRDDBI Handle (Oracle 8.x and later)

    LRDRET lrd_handle_alloc( unsigned int muiDBType, void *mpvLRDDBIHandleParent, long mliDBHandleType, void **mppvLRDDBIHandle, int miDBErrorSeverity );

muiDBType | The target database type.
mpvLRDDBIHandleParent | A pointer to the parent LRDDBI handle.
mliDBHandleType | An LRDDBI handle type : an option of LRD_HTYPE.
mppvLRDDBIHandle | A pointer to a pointer to the LRDDBI handle.
miDBErrorSeverity | The Error Severity Levels of a failure in a database routine.

The lrd_handle_alloc function allocates and initializes an LRDDBI handle. Note that the parent handle must be allocated before calling this function, explicitly using lrd_handle_alloc, or implicitly using lrd_logon.

For more details refer to the Function Header File lrd.h in the include directory.

## Return Values

See LRD Return Values.

## Parameterization

You cannot use standard parameterization for any arguments in this function.

## Example

In the following example, lrd_handle_alloc allocates and initializes an authentication handle.

    lrd_handle_alloc (LRD_DBTYPE_ORACLE, OraEnv1,
               LRD_HTYPE_ORACLE_STMT, &OraStm1, 0);
    lrd_ora8_stmt(OraStm1, "begin dbms_output.disable; end;", 1, 0, 0);
    lrd_ora8_exec(OraSvc1, OraStm1, 1, 0, &uliRowsProcessed, 0, 0, 0, 0, 0);
    lrd_handle_free(&OraStm1, 0);

Tips to improve your search results... VuGen Function Reference Version 26.1 Function Reference 26.1 All View Local Help Center View Online Help Center Version: