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.