DL_ChangeDbOwner(3)DL_ChangeDbOwner(3)NAME
DL_ChangeDbOwner, CSSM_DL_ChangeDbOwner - Define a new data base owner
(CDSA)
SYNOPSIS
# include <cdsa/cssm.h>
API: CSSM_RETURN CSSMAPI CSSM_DL_ChangeDbOwner (CSSM_DL_DB_HANDLE DLDB‐
Handle, 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_CRE‐
DENTIALS *AccessCred, const CSSM_ACL_OWNER_PROTOTYPE *NewOwner)
LIBRARY
Common Security Services Manager library (libcssm.so)
PARAMETERS
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 creden‐
tials 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 val‐
ues 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
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 repre‐
sent an error condition.
ERRORS
Errors are described in the CDSA technical standard. See
CDSA_intro(3). CSSMERR_DL_INVALID_DB_HANDLE CSS‐
MERR_DL_INVALID_NEW_OWNER
SEE ALSO
Books
Intel CDSA Application Developer's Guide (see CDSA_intro(3))
Reference Pages
Functions for the CSSM API:
CSSM_DL_GetDbOwner(3)
Functions for the DL SPI:
DL_GetDbOwner(3)DL_ChangeDbOwner(3)