NAME
   CSSM_HRS_DbStoreBIR, HRS_DbStoreBIR

 SYNOPSIS

 #include <hrs.h>

 API
   CSSM_RETURN CSSMAPI CSSM_HRS_DbStoreBIR(
                          CSSM_HRS_HANDLE ModuleHandle,
                          const CSSM_HRS_INPUT_BIR *BIRToStore,
                          CSSM_HRS_DB_HANDLE DbHandle,
                          CSSM_GUID_PTR Guid);
 SPI
   CSSM_RETURN CSSMHRI HRS_DbStoreBIR(
                          CSSM_HRS_HANDLE ModuleHandle,
                          const CSSM_HRS_INPUT_BIR *BIRToStore,
                          CSSM_HRS_DB_HANDLE DbHandle,
                          CSSM_GUID_PTR Guid);

 LIBRARY
   HRS Extensible Module Manager (CDSA$INHRSEMM_SHR.EXE)

 PARAMETERS
   The parameter definitions are the same for the API and the SPI.

   ModuleHandle (input)        The handle of the attached HRS
                               service provider.
   BIRToStore (input)          The BIR to be stored in the open
                               database (either the BIR, or its handle,
                               or the index to it in another open
                               database).
   DbHandle (input)            The handle to the open database.
   Guid (output)               A GUID that uniquely identifies the new
                               BIR in the database. This GUID cannot
                               be changed.  To associate a different
                               BIR with the user, it is necessary to
                               delete the old one, store a new one in
                               the database, and then replace the old
                               GUID with the new one in the application
                               account database.

 DESCRIPTION
   The BIR identified by the BIRToStore parameter is stored in the
   open database identified by the DbHandle parameter. If the
   BIRToStore is identified by a BIR Handle, the input BIR Handle is
   freed. If the BIRToStore is identified by a database key value,
   the BIR is copied to the open database.

   A new GUID is assigned to the new BIR in the database, and this
   GUID can be used as a key value to access the BIR later.

 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_CSSM_NOT_INITIALIZED
   CSSMERR_CSSM_FUNCTION_FAILED
   CSSMERR_CSSM_FUNCTION_NOT_IMPLEMENTED
   CSSMERR_CSSM_FUNCTION_INTEGRITY_FAIL