sc_verify()

Perform card holder verification.

Synopsis:

#include <smartcard/sc_smart_card.h>

sc_response_code_t sc_verify(sc_context_t *context,                 
                             const unsigned char *code,                 
                             size_t code_length,                 
                             sc_ihv_mode_t ihv_mode,                 
                             unsigned int *ref)

Since:

BlackBerry 10.2.0

Arguments:

context: The active smart card context. This value cannot be NULL.

code: The smart card code (the PIN) used to authenticate the user to the card. If the value is NULL, the user is prompted to enter the smart card PIN.

code_length: The code length.

ihv_mode: Indicates whether CHV is to be made against a local (SC_FL_IHV_LOCAL) or global (SC_FL_IHV_GLOBAL) code. If the SC_FL_IHV_CHECKONLY flag is specified, then no UI should be presented to obtain CHV from the device user.

ref: A vendor-specific reference value.

Library:

libscs (For the qcc command, use the -l scs option to link against this library)

Description:

If the code argument is provided, it is sent to the card for verification. If no code value is provided, then the user is prompted to enter the smart card PIN. If the cardholder verification (CHV) requirements for the currently selected path are already satisfied, for example, by a prior CHV, then the service provider returns SC_SCARD_S_SUCCESS.

A handle of type SC_HANDLE_CARD_HOLDER_VERIFIER must be allocated before calling this function; otherwise an error is returned.

Returns:

SC_SCARD_S_SUCCESS upon success, an error code otherwise. See sc_response_code_t for defined error codes.