CSSM_CL_CrlGetFirstFieldValue man page on DigitalUNIX

Man page or keyword search:  
man Server   12896 pages
apropos Keyword Search (all sections)
Output format
DigitalUNIX logo
[printable version]

CL_CrlGetFirstFieldValue(3)			   CL_CrlGetFirstFieldValue(3)

NAME
       CL_CrlGetFirstFieldValue, CSSM_CL_CrlGetFirstFieldValue - Get the value
       of the first CRL field (CDSA)

SYNOPSIS
       # include <cdsa/cssm.h>

       API: CSSM_RETURN CSSMAPI CSSM_CL_CrlGetFirstFieldValue  (CSSM_CL_HANDLE
       CLHandle,  const	 CSSM_DATA  *Crl,  const CSSM_OID *CrlField, CSSM_HAN‐
       DLE_PTR	ResultsHandle,	uint32	*NumberOfMatchedFields,	 CSSM_DATA_PTR
       *Value) SPI: CSSM_RETURN CSSMCLI CL_CrlGetFirstFieldValue (CSSM_CL_HAN‐
       DLE CLHandle, const CSSM_DATA *Crl, const CSSM_OID *CrlField, CSSM_HAN‐
       DLE_PTR	ResultsHandle,	uint32	*NumberOfMatchedFields,	 CSSM_DATA_PTR
       *Value)

LIBRARY
       Common Security Services Manager library (libcssm.so)

PARAMETERS
       The handle that describes the add-in Certificate Library module used to
       perform	this function.	A pointer to the CSSM_DATA structure that con‐
       tains the CRL from which the field is to be retrieved.  An object iden‐
       tifier that identifies the field value to be extracted from the CRL.  A
       pointer to the CSSM_HANDLE that should be used to obtain any additional
       matching	 fields.   The	total number of fields that match the CrlField
       OID. This count includes the first match, which was  returned  by  this
       function.   A  pointer  to  the	structure  containing the value of the
       requested field. The structure and the field at I "(*Value)->Data"  are
       allocated  by  the service provider. The CSSM_CL_FreeFieldValue() (CSSM
       API), or CL_FreeFieldValue() (CL SPI), function can be used to  deallo‐
       cate *Value and (*Value)->Data.

DESCRIPTION
       This  function  returns	the  value  of the CRL field designated by the
       CSSM_OID CrlField. The OID also identifies  the	data  format  for  the
       field  value returned to the caller. If multiple OIDs name the same CRL
       field, then each OID defines a distinct data format  for	 the  returned
       field  value.  The  function CSSM_CL_CrlDescribeFormat() (CSSM API), or
       CL_CrlDescribeFormat() (CL SPI), provides a list of all CSSM_OID values
       supported by a Certificate Library module for naming fields of a CRL.

       If  more	 than  one  field matches the CrlField OID, the first matching
       field will be returned. The number of  matching	fields	is  an	output
       parameter, as is the ResultsHandle to be used to retrieve the remaining
       matching fields.

       The set of matching fields is determined by this function.  The	number
       of  matching  fields  and  the  field values do not change between this
       function and subsequent calls to	 CSSM_CL_CrlGetNextFieldValue()	 (CSSM
       API), or CL_CrlGetNextFieldValue() (CL SPI).

RETURN VALUE
       A CSSM_RETURN value indicating success or specifying a particular error
       condition. The value CSSM_OK indicates success. All other values repre‐
       sent an error condition.

ERRORS
       Errors	are   described	  in   the   CDSA   technical  standard.   See
       CDSA_intro(3).  CSSMERR_CL_INVALID_CRL_POINTER  CSSMERR_CL_UNKNOWN_FOR‐
       MAT CSSMERR_CL_UNKNOWN_TAG CSSMERR_CL_NO_FIELD_VALUES

SEE ALSO
       Books

       Intel CDSA Application Developer's Guide (see CDSA_intro(3))

       Reference Pages

       Functions for the CSSM API:

       CSSM_CL_CrlGetNextFieldValue(3), CSSM_CL_CrlAbortQuery(3), CSSM_CL_Crl‐
       GetAllFields(3)

       Functions for the CLI SPI:

       CL_CrlGetNextFieldValue(3), CL_CrlAbortQuery(3), CL_CrlGetAllFields(3)

						   CL_CrlGetFirstFieldValue(3)
[top]

List of man pages available for DigitalUNIX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net