NAME

CSSM_GetContextAttribute − Get context attribute (CDSA)

SYNOPSIS

# include <cdsa/cssm.h>

CSSM_RETURN CSSMAPI CSSM_GetContextAttribute
(const CSSM_CONTEXT ∗Context,
uint32 AttributeType,
CSSM_CONTEXT_ATTRIBUTE_PTR ∗ContextAttribute)

LIBRARY

Common Security Services Manager library (libcssm.so)

PARAMETERS

Context (input)
A pointer to the context.

AttributeType (input)
The attribute type of the desired attribute value.

ContextAttribute (output)
The pointer to the CSSM_CONTEXT_ATTRIBUTE that describes the context attributes associated with the CCHandle handle and the attribute type. The pointer will be set to NULL if the function fails.  Call CSSM_DeleteContextAttributes() to free memory allocated by the CSSM. 

DESCRIPTION

This function returns the value of a context attribute. Context references the cryptographic context to be searched for the attribute specified by AttributeType. If the specified attribute is not present, then a NULL pointer is returned. 

RETURN VALUE

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

Errors are described in the CDSA technical standard.  See CDSA_intro(3). 

CSSMERR_CSSM_ATTRIBUTE_NOT_IN_CONTEXT

SEE ALSO

Books

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

Reference Pages

Functions: CSSM_DeleteContextAttributes(3), CSSM_GetContext(3)