Index for Section 3

Alphabetical listing for D

Bottom of page

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 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 (libcssm.so)

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_intro(3).

       CSSMERR_DL_INVALID_DB_HANDLE
       CSSMERR_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)

Index for Section 3

Alphabetical listing for D

Top of page