gsk_get_record_by

Gets one or more database records using the certificate subject.

Format

   #include <gskcms.h>

   gsk_status gsk_get_record_by_subject (   
                                          gsk_handle               db_handle,  
                                          x509_name *              name,    
                                          int *                    num_records,   
                                          gskdb_record ***         records)

Parameters

db_handle: Specifies the database handle returned by the gsk_create_database() routine, the gsk_open_database() routine, or the gsk_open_keyring() routine.
name: Specifies the certificate subject.
num_records: Returns the number of records in the array.
records: Returns the array of database records. The application should call the gsk_free_records() routine to release the array when it is no longer needed.

Results

The function return value will be 0 if no error is detected. Otherwise, it will be one of the return codes listed in the gskcms.h include file. These are some possible errors:

[CMSERR_BAD_HANDLE]: The database handle is not valid.
[CMSERR_INCORRECT_DBTYPE]: The database does not support this operation.
[CMSERR_NO_MEMORY]: Insufficient storage is available.
[CMSERR_RECORD_NOT_FOUND]: The requested record is not found.

Usage

The gsk_get_record_by_subject() routine retrieves all records from a key database with the specified subject name. When matching UTF-8 encoded attribute values (gsk_string_utf8) in the subject name, System SSL uses a case sensitive (exact match) comparison.