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.