Vtk_CertGetExtensions
Toolkit Reference

prevnext

Vtk_CertGetExtensions

#include <vtk_cert.h>
#include <vtk_defs.h>
#include <vtk_errs.h>
Vtk_uint32 Vtk_CertGetExtensions(
const Vtk_Ctxt* ctxt, /* input */
const Vtk_Cert *from, /* input */
Vtk_Extensions **into /* output */
);

Description

This certificate encapsulation function returns a list of certificate extensions for a specified certificate in the specified context. This function allows you to directly get the list of extensions for the certificate without getting all of the certificate information contained in the Vtk_CertInfo structure.

The Toolkit provides several other functions that allow your application to parse the Vtk_Extensions structure and return the following:

Parameters

ctxt Pointer to Toolkit context created using the Vtk_CtxtNew function and for which memory has been allocated.
from Pointer to the certificate for which the extensions are to be returned.
into Pointer to structure into which the list of certificate extensions is to be placed.

Return Value

VTK_OK The function has completed successfully and the list of certificate extensions has been placed into the structure.
error code The function has failed. For information about possible error values, refer to Appendix 

Notes

The application must call the Vtk_ExtensionsDelete function for the structure returned by Vtk_CertGetExtensions. If the application does not call Vtk_ExtensionsDelete, memory leaks and other problems can occur. For more information about the memory model employed by the Toolkit, see Toolkit Memory Model.
In the case that the certificate has no extension, the function returns VTK_OK and sets the specified output structure to NULL.


See Also

Vtk_CertInfo

Vtk_ExtensionGetByOid

Vtk_ExtensionsDelete

Vtk_ExtensionsGetCount

Vtk_ExtensionsGetith

prevnext


ValiCert, Inc.
http://www.valicert.com
Voice: +1.650.567.5469
Fax: (+1.650.254.2148
support@valicert.com