HRS_DbQueryBIR

NAME
  CSSM_HRS_DbQueryBIR, HRS_DbQueryBIR

SYNOPSIS

#include <hrs.h>

API
  CSSM_RETURN CSSMAPI CSSM_HRS_DbQueryBIR(
                         CSSM_HRS_HANDLE ModuleHandle,
                         CSSM_HRS_DB_HANDLE DbHandle,
                         const CSSM_HRS_INPUT_BIR *BIRToQuery,
                         CSSM_GUID_PTR Guid);
SPI
  CSSM_RETURN CSSMHRI HRS_DbQueryBIR(
                         CSSM_HRS_HANDLE ModuleHandle,
                         CSSM_HRS_DB_HANDLE DbHandle,
                         const CSSM_HRS_INPUT_BIR *BIRToQuery,
                         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.
  DbHandle (input)            The handle to the open database.
  BIRToQuery (input)          The BIR to be queried in the open
                              database (either the BIR, or its
                              handle, or the key to it in another
                              open database).
  Guid (output)               The GUID that uniquely identifies
                              the BIR in the database.

DESCRIPTION
  If the BIR identified by the BIRToQuery parameter is in the open
  database identified by the DbHandle parameter, a pointer to its
  GUID is returned. Otherwise, CSSMERR_HRS_RECORD_NOT_FOUND is
  returned.

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_RECORD_NOT_FOUND