z/OS Cryptographic Services System SSL Programming
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


gsk_get_dn_by_label()

z/OS Cryptographic Services System SSL Programming
SC14-7495-00

Gets the distinguished name for a certificate.

Format

   #include <gskssl.h>

   char * gsk_get_dn_by_label(
                               const char *     label)

Parameters

label
Specifies the key label.

Usage

The gsk_get_dn_by_label() routine returns the distinguished name for the certificate associated with the key label. The gsk_initialize() routine must be called before the gsk_get_dn_by_label() routine can be called. The application should release the returned name when it is no longer needed by calling the gsk_free_memory() routine. The return value will be NULL if an error occurred while accessing the key database or when using z/OS® PKCS #11 token and multiple certificates exist for the specified label.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014