CSSM_CL_CertGetNextFieldValue man page on OSF1

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

CL_CertGetNextFieldValue(3)			   CL_CertGetNextFieldValue(3)

NAME
       CL_CertGetNextFieldValue,  CSSM_CL_CertGetNextFieldValue	 -  Return the
       value of a certificate field (CDSA)

SYNOPSIS
       # include <cdsa/cssm.h>

       API: CSSM_RETURN CSSMAPI CSSM_CL_CertGetNextFieldValue  (CSSM_CL_HANDLE
       CLHandle,   CSSM_HANDLE	 ResultsHandle,	  CSSM_DATA_PTR	 *Value)  SPI:
       CSSM_RETURN CSSMCLI CL_CertGetNextFieldValue (CSSM_CL_HANDLE  CLHandle,
       CSSM_HANDLE ResultsHandle, 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.  The handle that identifies  the	results	 of  a
       certificate  query.  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
       deallocate *Value and (*Value)->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‐
       FieldValue()  (CSSM  API),  or  CL_CertGetFirstFieldValue()  (CL	 SPI),
       returns a results handle identifying the size and values	 contained  in
       the  result  set.  The  CSSM_CL_CertGetNextFieldValue()	(CSSM API), or
       CL_CertGetNextFieldValue() (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_CertGetFirstFieldValue(3),	    CSSM_CL_CertAbortQuery(3),
       CSSM_CL_FreeFieldValue(3)

       Functions for the CLI SPI:

       CL_CertGetFirstFieldValue(3),	CL_CertAbortQuery(3),	 CL_FreeField‐
       Value(3)

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

List of man pages available for OSF1

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