Library /sys$common/syshlp/helplib.hlb  —  System Services, $PERSONA CREATE EXTENSION (Alpha and Integrity servers)
    On Alpha and Integrity server systems, creates an extension on
    the current persona. A persona extension is a mechanism to attach
    support for additional security credentials.

    Format

      SYS$PERSONA_CREATE_EXTENSION  persona ,extensionID ,buffer

                                    ,length ,flags

    C Prototype

      int sys$persona_create_extension  (unsigned int *persona,

                                        unsigned int *extensionID,

                                        void *buffer, unsigned

                                        int *length, unsigned int

                                        *flags);

1  –  Arguments

 persona

    OpenVMS usage:persona
    type:         longword (unsigned)
    access:       read only
    mechanism:    by reference
    Address of a longword containing the persona identification to
    which $PERSONA_CREATE_EXTENSION attaches a new persona extension.

    Two special values for persona are also permitted: 0, which means
    the current persona, and -1, which means the process' natural
    persona is used.

 extensionID

    OpenVMS usage:extension_ID
    type:         longword (unsigned)
    access:       read only
    mechanism:    by reference
    Address of a longword containing the extension identification
    (EID) for which the registered CREATE routine will be called to
    create a new persona extension block.

 buffer

    OpenVMS usage:address
    type:         longword (unsigned)
    access:       read only
    mechanism:    by reference
    Address of a buffer containing data to be used in creating the
    persona extension data structure. The interpretation of the
    data within this buffer is the responsibility of the extension
    create routine. For example, this data could be a Type-Length-
    Value (TLV) structure containing fields in the extension data
    structure. Specifying this buffer is optional; a caller who does
    not want to supply a buffer should specify an address of zero
    (0).

 length

    OpenVMS usage:size
    type:         longword (unsigned)
    access:       read only
    mechanism:    by reference
    Address of a longword containing the size, in bytes, of the
    buffer argument. Specifying length is optional; a caller who
    does not want to supply a length should specify an address of
    zero (0). Specifying a buffer without a length is the same as not
    specifying a buffer.

 flags

    OpenVMS usage:flags
    type:         longword (unsigned)
    access:       read only
    mechanism:    by reference
    Flag mask specifying the options to be employed when the persona
    extension is created. Specifying flags is optional; a caller who
    does not want to supply flags should specify an address of zero
    (0).

    Flag       Description

    PXB$V_     This extension is recorded as the persona's primary
    PRIMARY_   extension. If a persona already has a primary
    EXTENSION  extension, the error SS$_UNSUPPORTED is returned and
               the extension is not created. The primary extension is
               returned when the persona is queried for its "Primary
               Extension." There is no other meaning for this value.
Close Help