Copyright Digital Equipment Corp. All rights reserved.

HRS_DbDeleteBIR

NAME
  CSSM_HRS_DbDeleteBIR, HRS_DbDeleteBIR

SYNOPSIS

#include <hrs.h>

API
  CSSM_RETURN CSSMAPI CSSM_HRS_DbDeleteBIR(
                         CSSM_HRS_HANDLE ModuleHandle,
                         CSSM_HRS_DB_HANDLE DbHandle,
                         const CSSM_GUID *KeyValue);
SPI
  CSSM_RETURN CSSMHRI HRS_DbDeleteBIR(
                         CSSM_HRS_HANDLE ModuleHandle,
                         CSSM_HRS_DB_HANDLE DbHandle,
                         const CSSM_GUID *KeyValue);

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.
  DbHandle (input)            The handle to the open database.
  KeyValue (input)            The GUID of the BIR to be deleted.

DESCRIPTION
  The BIR identified by the KeyValue parameter in the open database
  identified by the DbHandle parameter is deleted from the database.

  If there is a cursor set to the deleted BIR, then the cursor is
  moved to the next sequential BIR (or set to the start of the
  database if there are no more records).

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
  CSSMERR_HRS_END_OF_DATABASE
  CSSMERR_HRS_RECORD_NOT_FOUND