operateCredential

Requests the operation of a credential with the supplied parameters. For example, calling this method is the first step in the offline PIN unlock operation (this applies to offline PIN unlock only).

This entry point may result in the following to occur:

Retrieve an external operation using getNextExternalOperations.
Process externally.
Return it to the CredentialManager using the same entry point.

This executes the OPER_ID_CRED_UNLOCK operation.

All other operations result in an InvalidStateException.

If a credential ID is presented that is not of the type CRED_ID_TYPE_PIN, then a check for its existence is made, and one of the following exceptions is thrown:

InvalidStateException—if the specified credential exists.
NoSuchCredentialException—if the specified credential is not found.

For Java:

Copy

TransactionId operateCredential(
CredentialId credId, String operation, Parameter[] parameters)
throws NoSuchCredentialException, MalformedDataException, InvalidStateException, SessionException, ManagementException, LocalizedRemoteException;

For C++:

Copy

TransactionId *operateCredential(
CredentialId *credId, TString operation, ParameterVector *parameters);

Parameters:

credId—Credential identifier.
operation—Credential operation requested for the specified Credential.
parameters—Input parameters required to perform the operation, or an empty array.

Returns:

The transaction identifier to facilitate potential further steps required for credential update.

Exceptions:

NoSuchCredentialException—if the specified credential is not found or not valid.
MalformedDataException—if the input data was malformed.
InvalidStateException—if credential update violates the credential's lifecycle.
SessionException—if there is no valid session (such as session not opened or timed out).
ManagementException—if an internal failure occurs.
LocalizedRemoteException— (thrown by the Web service layer) only when the most severe, unexpected, SOAP-level failures occur.