gsk_query_database

Determines if a database label exists

Format

#include <gskcms.h>

gsk_status gsk_query_database_label (
                                     gsk_handle               db_handle,
                                     const char *             label)

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.
label: Specifies the database label. The label is specified in the local code page.

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_BAD_LABEL]: No label specified.
[CMSERR_MULTIPLE_LABEL]: Multiple certificates exist for label.
[CMSERR_RECORD_NOT_FOUND]: The label does not exist in the database.

Usage

The gsk_query_database_label() routine will check the database for the requested label.