Generic Security Services API Library Functions
                                   gsscreateemptyoidset(3GS)



NAME
     gsscreateemptyoidset - create an  object-identifier  set
     containing no object identifiers

SYNOPSIS
     cc [ flag... ] file... -lgss  [ library... ]
     #include 

     OMuint32 gsscreateemptyoidset(OMuint32 *minorstatus,
          gssOIDset *oidset);


DESCRIPTION
     The gsscreateemptyoidset() function creates  an  object-
     identifier  set  containing  no  object identifiers to which
     members   may    be    subsequently    added    using    the
     gssaddoidsetmember(3GS)  function.  These functions can
     be used to construct sets of  mechanism  object  identifiers
     for input to gssacquirecred(3GS).

PARAMETERS
     The parameter  descriptions  for  gsscreateemptyoidset()
     follow:

     minorstatus    Mechanism-specific status code


     oidset         Empty object identifier  set.  The  function
                     will  allocate  the gssOIDsetdesc object,
                     which the  application must free  after  use
                     with a call to gssreleaseoidset(3GS).


ERORS
     The gsscreateemptyoidset() function may return the  fol-
     lowing status codes:

     GSCOMPLETE    Successful completion


     GSFAILURE     The underlying mechanism detected an error
                       for  which  no specific GS status code is
                       defined.   The  mechanism-specific  status
                       code reported by means of the minorstatus
                       parameter details the error condition.


ATRIBUTES
     See attributes(5)  for descriptions of the following  attri-
     butes:




SunOS 5.11          Last change: 14 Jan 2003                    1






Generic Security Services API Library Functions
                                   gsscreateemptyoidset(3GS)



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Availability                 SUNWgss (32-bit)            
    
                                  SUNWgssx (64-bit)           
    
     MT-Level                     Safe                        
    


SEE ALSO
     gssacquirecred(3GS),        gssaddoidsetmember(3GS),
     gssreleaseoidset(3GS), attributes(5)


     Solaris Security for Developers Guide





































SunOS 5.11          Last change: 14 Jan 2003                    2






Generic Security Services API Library Functions
                                   gsscreateemptyoidset(3GS)






















































SunOS 5.11          Last change: 14 Jan 2003                    3