*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Tru64 Unix man pages -> CSSM_CL_CertAbortQueryfunction (3)              



NAME    [Toc]    [Back]

       CL_CertAbortQuery,  CSSM_CL_CertAbortQuery function - Terminate
 a results handle (CDSA)

SYNOPSIS    [Toc]    [Back]

       # include <cdsa/cssm.h>

       API:    CSSM_RETURN     CSSMAPI     CSSM_CL_CertAbortQuery
       (CSSM_CL_HANDLE CLHandle, CSSM_HANDLE ResultsHandle)

       SPI:     CSSM_RETURN     CSSMAPI    CSSM_CL_CertAbortQuery
       (CSSM_CL_HANDLE CLHandle, CSSM_HANDLE ResultsHandle)

LIBRARY    [Toc]    [Back]

       Common Security Services Manager library (libcssm.so)

PARAMETERS    [Toc]    [Back]

       The handle that describes the add-in  certificate  library
       module  used  to  perform this function.  A pointer to the
       handle that identifies the results of a  CSSM_CL_GetFieldValue()
   (CSSM  API),  or  CL_GetFieldValue()  (CLI  SPI)

DESCRIPTION    [Toc]    [Back]

       This function terminates a results handle used  to  access
       multiple  certificate  fields  identified by a single OID.
       The   ResultsHandle   was   created   and   returned    by
       CSSM_CL_CertGetFirstFieldValue()  (CSSM  API), or CL_CertGetFirstFieldValue()
 (CL  SPI),  or  CSSM_CL_CertGetFirstCachedFieldValue()
  (CSSM  API), or CL_CertGetFirstCachedFieldValue()
 (CL SPI).

       The CL releases all intermediate state information associated
  with  the  repeating-value query. Once this function
       has been invoked, the results handle is invalid.

       Applications must invoke this function  to  terminate  the
       ResultsHandle. Using CSSM_CL_CertGetNextFieldValue() (CSSM
       API),   or   CL_CertGetNextFieldValue()   (CL   SPI),   or
       CSSM_CL_CertGetNextCachedFieldValue()   (CSSM   API),   or
       CL_CertGetNextCachedFieldValue() (CL SPI), to  access  all
       of the attributes named by a single OID does not terminate
       the ResultsHandle.

       This function can be invoked to terminate the results handle
  without accessing all values identified by the single

RETURN VALUE    [Toc]    [Back]

       A CSSM_RETURN value indicating  success  or  specifying  a
       particular  error  condition.  The value CSSM_OK indicates
       success. All other values represent an error condition.

ERRORS    [Toc]    [Back]

       Errors are described in the CDSA technical standard.   See

SEE ALSO    [Toc]    [Back]


       Intel    CDSA    Application    Developer's   Guide   (see

       Reference Pages    [Toc]    [Back]

       Functions for the CSSM API:

       CSSM_CL_CertGetFirstFieldValue(3),        CSSM_CL_CertGetNextFieldValue(3),        CSSM_CL_CertGetFirstCachedFieldValue(3), CSSM_CL_CertGetNextCachedFieldValue(3)

       Functions for the CLI SPI:

       CL_CertGetFirstFieldValue(3), CL_CertGetNextFieldValue(3),
       CL_CertGetFirstCachedFieldValue(3),  CL_CertGetNextCachedFieldValue(3)

[ Back ]
 Similar pages
Name OS Title
CL_CrlAbortCache Tru64 Terminate a CRL cache handle (CDSA)
CSSM_CL_CrlAbortCache Tru64 Terminate a CRL cache handle (CDSA)
CSSM_CL_CertAbortCache Tru64 Terminate a certificate cache handle (CDSA)
CL_CertAbortCache Tru64 Terminate a certificate cache handle (CDSA)
CSSM_TP_RetrieveCredResult Tru64 Return the results of the credentials request (CDSA)
CSSM_Terminate Tru64 Terminate the use of CSSM (CDSA)
CL_CrlAbortQuery Tru64 Terminate a query (CDSA)
CSSM_CL_CrlAbortQuery Tru64 Terminate a query (CDSA)
DL_DataAbortQuery Tru64 Terminate DL_DataGetFirst query (CDSA)
CSSM_CSP_Logout Tru64 Terminate the login session (CDSA)
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service