Parameters

For the definitions of the return_code, reason_code, exit_data_length, and exit_data parameters, see Parameters common to all verbs.

rule_array_count

Direction:	Input
Type:	Integer

A pointer to an integer variable containing the number of elements in the rule_array variable. This value must be 0.

rule_array

Direction:	Input
Type:	String array

This parameter is ignored.

key_label_mask

Direction:	Input
Type:	String

A pointer to a string variable containing a key-label mask that is used to filter the list of key names returned by the verb. Use a wild card (*) to identify multiple key records retained within the coprocessor.

retained_keys_count

Direction:	Input/Output
Type:	Integer

A pointer to an integer variable to receive the total number of retained-key records stored within the coprocessor.

key_labels_count

Direction:	Input/Output
Type:	Integer

A pointer to an integer variable which on input defines the maximum number of key labels to be returned, and which on output defines the number of key labels returned by the coprocessor.

key_labels

Direction:	Output
Type:	String array

A pointer to a string array variable containing the returned key labels. The coprocessor returns zero or more 64-byte array elements, each of which contains the key label of a PKA key-record retained within the coprocessor.