NAME    [Toc]    [Back]

       DL_ChangeDbOwner,  CSSM_DL_ChangeDbOwner  -  Define  a new
       data base owner (CDSA)

SYNOPSIS    [Toc]    [Back]

       # include <cdsa/cssm.h>

       API:     CSSM_RETURN     CSSMAPI     CSSM_DL_ChangeDbOwner
       (CSSM_DL_DB_HANDLE  DLDBHandle,  const CSSM_ACCESS_CREDENTIALS
    *AccessCred,    const    CSSM_ACL_OWNER_PROTOTYPE
       *NewOwner)   SPI:   CSSM_RETURN  CSSMDLI  DL_ChangeDbOwner
       (CSSM_DL_DB_HANDLE DLDBHandle,  const  CSSM_ACCESS_CREDENTIALS
    *AccessCred,    const    CSSM_ACL_OWNER_PROTOTYPE
       *NewOwner)

LIBRARY    [Toc]    [Back]

       Common Security Services Manager library (libcssm.so)

PARAMETERS    [Toc]    [Back]

       The handle pair that describes the  data  storage  library
       module  to  be used to perform this function, and the open
       data store whose associated Owner is  to  be  updated.   A
       pointer  to  the  set  of  one or more credentials used to
       prove the caller is the current Owner of  the  Data  Base.
       Required  credentials  can  include  zero or more certificates,
 zero or more caller names, and one or more samples.
       If  certificates and/or caller names are provided as input
       these must be provided as immediate values in this  structure.
  The  samples can be provided as immediate values or
       can be obtained through a callback  function  included  in
       the   AccessCred  structure.   A  CSSM_ACL_OWNER_PROTOTYPE
       defining the new Owner of the Data Base.

DESCRIPTION    [Toc]    [Back]

       This function takes  a  CSSM_ACL_OWNER_PROTOTYPE  defining
       the new Owner of the Data Base.

RETURN VALUE    [Toc]    [Back]

       A  CSSM_RETURN  value  indicating  success or specifying a
       particular error condition. The  value  CSSM_OK  indicates
       success. All other values represent an error condition.

ERRORS    [Toc]    [Back]

       Errors  are described in the CDSA technical standard.  See
       CDSA_intro(3).      CSSMERR_DL_INVALID_DB_HANDLE      CSSMERR_DL_INVALID_NEW_OWNER

SEE ALSO    [Toc]    [Back]

       Books

       Intel    CDSA    Application    Developer's   Guide   (see
       CDSA_intro(3))

       Reference Pages    [Toc]    [Back]

       Functions for the CSSM API:

       CSSM_DL_GetDbOwner(3)

       Functions for the DL SPI:

       DL_GetDbOwner(3)



                                              DL_ChangeDbOwner(3)