Deregister Application for Certificate Use (QSYDRGAP, QsyDeregisterAppForCertUse) API

Required Parameter Group for QSYDRGAP:

1	Application ID	Input	Char(*)
2	Length of application ID	Input	Binary(4)
3	Error code	I/O	Char(*)

Default Public Authority: *EXCLUDE

Threadsafe: Yes

Syntax for QsyDeregisterAppForCertUse:

 #include <qsyrgap1.h>

 void QsyDeregisterAppForCertUse
        (char           *Application_ID,
         int            *Length_of_application_ID,
         void           *Error_code);

  Service Program: QSYRGAP1

  Default Public Authority: *EXCLUDE

  Threadsafe: Yes

The Deregister Application for Certificate Use (OPM, QSYDRGAP; ILE, QsyDeregisterAppForCertUse) API removes an application and all associated certificate information from the registration facility. When an object signing application is deregistered, the corresponding function with the same ID also will be deregistered (see Deregister Function (QSYDRGFN, QsyDeregisterFunction) API). The corresponding function was registered when the object signing application was registered.

Authorities and Locks

API Public Authority: *EXCLUDE
Registration Lock: *EXCL

Required Parameter Group

Application ID

INPUT; CHAR(*)

The ID for the application being removed.

The following can be specified for the application ID:

generic*	All applications that have IDs beginning with the generic string.
application ID	Specific application ID.

Length of application ID

INPUT; BINARY(4)

The length of the specified application ID. The length must be a value from 1 to 100.

Error code

I/O; CHAR(*)

The structure in which to return error information. For the format of the structure, see Error code parameter.

Error Messages

Message ID	Error Message Text
CPF220E E	Application &1 not registered.
CPF3C90 E	Literal value cannot be changed.
CPF3CD9 E	Requested function cannot be performed at this time.
CPF3CDA E	Registration facility repository not available for use.
CPF3CF1 E	Error code parameter not valid.
CPF3CF2 E	Error(s) occurred during running of &1 API.
CPF8100 E	All CPF81xx messages could be returned. xx is from 01 to FF.
CPF9810 E	Library &1 not found.
CPF9811 E	Program &1 in library &2 not found.
CPF9872 E	Program or service program &1 in library &2 ended. Reason code &3.

API introduced: V4R4

[ Back to top | Security APIs | APIs by category ]