DL_ChangeDbOwner

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