HELPLIB.HLB  —  RTL Routines, LIB$  LIB$GET_UIB_INFO
    Returns information from the unwind information block (UIB).

    Format

      LIB$GET_UIB_INFO  uib_va [,gp_value] [,uw_desc_va]

                        [,uw_desc_len] [,handler_fv] [,ossd_va]

                        [,lsda_va]

1  –  Returns

    OpenVMS usage:cond_value
    type:         longword (unsigned)
    access:       write only
    mechanism:    by value

2  –  Arguments

 uib_va

    OpenVMS usage: address
    type:          quadword (unsigned)
    access:        read only
    mechanism:     by reference
    Address of a quadword that contains the virtual address of an
    unwind information block (UIB).

 gp_value

    OpenVMS usage: address
    type:          quadword (unsigned)
    access:        read only
    mechanism:     by reference
    Address of a quadword that contains the GP value that must be
    added to the UIB condition handler value. Must be specified if
    handler_fv is specified.

 uw_desc_va

    OpenVMS usage: address
    type:          quadword (unsigned)
    access:        write
    mechanism:     by reference
    Address of a quadword to store the virtual address of the unwind
    descriptor area. If none is present, then zero is returned. This
    is an optional argument.

 un_desc_len

    OpenVMS usage: address
    type:          quadword (unsigned)
    access:        write
    mechanism:     by reference
    Address of a quadword to store the length (in bytes) of the
    unwind descriptor area. If none are present, then zero is
    returned. This is an optional argument.

 handler_fv

    OpenVMS usage: address
    type:          quadword (unsigned)
    access:        write
    mechanism:     by reference
    Address of a quadword to store the function value of the
    condition handler. If none is present, then zero is returned.
    This is an optional argument.

 ossd_va

    OpenVMS usage: address
    type:          quadword (unsigned)
    access:        write
    mechanism:     by reference
    Address of a quadword to store the address of the operating
    system-specific data area. If none is present, then zero is
    returned. This is an optional argument.

 lsda_va

    OpenVMS usage: address
    type:          quadword (unsigned)
    access:        write
    mechanism:     by reference
    Address of a quadword to store the address of the language-
    specific data area (LSDA). If none is present, then zero is
    returned. This is an optional argument.

3  –  Description

    Takes in the address of an uwind information block (UIB) and the
    GP value for a routine and returns the addresses of the start of
    the unwind descriptors (if any), the handler function descriptor
    (if any), and the operating system-specific data area (if any).
    The size in bytes of the unwind descriptors is also returned.

    Related Services

    SYS$SET_UNWIND_TABLE, SYS$CLEAR_UNWIND_TABLE, SYS$GET_UNWIND_
    ENTRY_INFO,

4  –  Condition Values Returned

    SS$_NORMAL         Routine completed successfully.
    LIB$_INVARG        Bad UIB virtual address.
Close Help