SmartCardHolderVerifier::verify()

Force a card holder verification against the smart card.

Synopsis:

#include <smartcard_spi/SmartCardHolderVerifier.hpp>

virtual sc_response_code_t smartcard_spi::SmartCardHolderVerifier::verify(const unsigned char *code, unsigned int codeLength, unsigned int flags, unsigned int &ref)

Since:

BlackBerry 10.3.0

Arguments:

code: The code used to verify the user with the card. If NULL, user will be prompted for a code.

codeLength: The code length.

flags: Indicates whether the 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, a pop-up dialog box requesting input of CHV information should not be presented; instead, only the CHV state should be returned.

ref: A vendor-specific reference value.

Library:

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

Description:

This function forces a card holder verification against the smart card. If a code is supplied, it is used to verify with the card. If no code is supplied, then the user will be prompted for a code. Note that if the CHV requirements for the currently selected path are satisfied (by a prior CHV), the service provider may simply return success.

Returns:

If successful, SCARD_S_SUCCESS is returned. Otherwise, an error code is returned.