Vtk_ExtensionGetByOid
Toolkit Reference

prevnext

Vtk_ExtensionGetByOid

#include <vtk_cert.h>
#include <vtk_defs.h>
#include <vtk_errs.h>
Vtk_uint32 Vtk_ExtensionGetByOid(
const Vtk_Ctxt *ctxt, /* input */
const Vtk_Extensions *exts, /* input */
const Vtk_Buffer *oid, /* input */
Vtk_Extension **dest /* output */
);


Description

This extension function can be used to search for a specific Object Identifier (OID) in the list of extensions currently in Vtk_Extensions structure. This search function can be used to search a list of any type of extensions, that is certificate, OCSP, CRT, or CRL extensions.

Parameters

ctxt Pointer to Toolkit context created using the Vtk_CtxtNew function and for which memory has been allocated.
exts Pointer to extensions structure that is to be parsed and for which memory has been allocated. It can be created using the Vtk_CertGetExtensions function or through the Vtk_ValRespDetails or Vtk_ValRespSingleCertDetails structure.
oid Pointer to the OID to search for within the Vtk_Extensions structure. The OID can be specified in dot notation.
dest Pointer to structure into which the extensions meeting the search criteria are to be placed.

Return Value

VTK_OK The function has completed successfully and the Vtk_Extension structure with the specified OID has been returned.
error code The function has failed. For information about possible error values, refer to Appendix 

Notes

The application must call Vtk_ExtensionDelete when finished with the returned structure, otherwise memory leaks and other problems can occur. For more information about the memory model employed by the Toolkit, see Toolkit Memory Model.



See Also

Vtk_ValRespDetails

Vtk_ValRespSingleCertDetails

Vtk_CertGetExtensions

Vtk_ErrorToString_r

prevnext


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