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

 SYNOPSIS
   # include <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
   Common Security Services Manager library (CDSA$INCSSM300_SHR.EXE)

 PARAMETERS
   DLDBHandle (input)
           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.

   AccessCred (input)
           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.

   NewOwner (input)
           A CSSM_ACL_OWNER_PROTOTYPE defining the new Owner of the Data
           Base.

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

 RETURN VALUE
   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
   Errors are described in the CDSA technical standard.  See CDSA.

        CSSMERR_DL_INVALID_DB_HANDLE
        CSSMERR_DL_INVALID_NEW_OWNER

 SEE ALSO
   Books

   Intel CDSA Application Developer's Guide (see CDSA)

   Other Help Topics

   Functions for the CSSM API:

       CSSM_DL_GetDbOwner

   Functions for the DL SPI:

       DL_GetDbOwner