gsk_decode_certification

Decodes a PKCS #10 certification request.

Format

   #include <gskcms.h>

   gsk_status gsk_decode_certification_request ( 
                                                 gsk_buffer *                stream, 
                                                 pkcs_cert_request *         request)

Parameters

stream: Specifies the encoded certification request.
request: Returns the decoded certification request. The application should call the gsk_free_certification_request() routine to release the decoded certification request when it is no longer needed.

Results

The function return value will be 0 if no error is detected. Otherwise, it will be one of the return codes listed in the gskcms.h include file. This is a possible error:

[ASN_NO_MEMORY]: Insufficient memory is available.

Usage

The gsk_decode_certification_request() routine decodes a Public Key Cryptography Standards (PKCS) certification request and returns the decoded information to the application. The request must have been encoded as described in PKCS #10, Version 1.7: Certification Request. The derRequestInfo field will contain the undecoded CertificationRequestInfo ASN.1 sequence for use in verifying the request signature, the certificationRequestInfo field will contain the decoded CertificationRequestInfo ASN.1 sequence, and the signatureAlgorithm and signatureValue fields will contain the request signature. The gsk_encode_signature() routine can be used to recreate the encoded certification request from the pkcs_cert_request structure returned by the gsk_decode_certification_request() routine.

Character strings contained in the request will be returned using UTF-8 encoding. If necessary, the application can call iconv() to convert the string to a different encoding.