CSSM_CL_CertGetNextCachedFieldValue man page on Tru64

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

CL_CertGetNextCachedFieldValue(3)	     CL_CertGetNextCachedFieldValue(3)

NAME
       CL_CertGetNextCachedFieldValue,	CSSM_CL_CertGetNextCachedFieldValue  -
       Return the value of a certificate field (CDSA)

SYNOPSIS
       # include <cdsa/cssm.h>

       API:    CSSM_RETURN     CSSMAPI	   CSSM_CL_CertGetNextCachedFieldValue
       (CSSM_CL_HANDLE	 CLHandle,  CSSM_HANDLE	 ResultsHandle,	 CSSM_DATA_PTR
       *FieldValue) SPI: CSSM_RETURN  CSSMAPI  CSSM_CL_CertGetNextCachedField‐
       Value	 (CSSM_CL_HANDLE    CLHandle,	 CSSM_HANDLE	ResultsHandle,
       CSSM_DATA_PTR *FieldValue)

LIBRARY
       Common Security Services Manager library (libcssm.so)

PARAMETERS
       The handle that describes the certificate library module used  to  per‐
       form  this  function.  The handle that identifies the results of a cer‐
       tificate query.	A pointer to the structure containing the value of the
       requested field. The structure and the field at I "(*FieldValue)->Data"
       are allocated by the  service  provider.	 The  CSSM_CL_FreeFieldValue()
       (CSSM  API),  or	 CL_FreeFieldValue()  (CL SPI) function can be used to
       deallocate *FieldValue and (*FieldValue)->Data.

DESCRIPTION
       This function returns the value of a certificate field, when that field
       occurs  multiple	 times	in  a  certificate. Certificates with repeated
       fields (such as multiple signatures) have multiple field values	corre‐
       sponding	 to a single OID. A call to the function CSSM_CL_CertGetFirst‐
       CachedFieldValue() (CSSM API), or CL_CertGetFirstCachedFieldValue() (CL
       SPI), returns a ResultsHandle identifying the size and values contained
       in the result set. The CSSM_CL_CertGetNextCachedFieldValue() (CSSMAPI),
       or  CL_CertGetNextCachedFieldValue()  (CL  SPI), function can be called
       repeatedly to obtain these values, one at a time. The result  set  does
       not change in size or value between calls to this function.

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_RESULTS_HANDLE	  CSS‐
       MERR_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_CertGetFirstCachedFieldValue(3),	    CSSM_CL_CertAbortCache(3),
       CSSM_CL_CertAbortQuery(3), CSSM_CL_CertGetAllFields(3), CSSM_CL_CertDe‐
       scribeFormat(3), CSSM_CL_FreeFieldValue(3)

       Functions for the CLI SPI:

       CL_CertGetFirstCachedFieldValue(3), CL_CertAbortCache(3), CL_CertAbort‐
       Query(3),       CL_CertGetAllFields(3),	     CL_CertDescribeFormat(3),
       CL_FreeFieldValue(3)

					     CL_CertGetNextCachedFieldValue(3)
[top]
                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 
More information is available in HTML format for server Tru64

List of man pages available for Tru64

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