RSA BSAFE Micro Edition Suite

Streamlined security for mobile and embedded devices
Search  Print

Information Identifiers

This section lists the information types that comprise a certificate request. The following table details the data types to pass into value when calling R_CERT_REQ_get_info(). 



 
Identifier Value Data Type  


R_CERT_REQ_INFO_VERSION int *  


R_CERT_REQ_INFO_SUBJECT R_TITEM *  


R_CERT_REQ_INFO_PUBLIC_KEY R_TITEM *  


R_CERT_REQ_INFO_ATTRIBUTES R_TITEM *  


R_CERT_REQ_INFO_TO_BE_SIGNED R_TITEM *  


R_CERT_REQ_INFO_SIGNATURE R_TITEM *  


R_CERT_REQ_INFO_ALL R_TITEM *  


R_CERT_REQ_INFO_TYPE R_CERT_REQ_TYPE *  


R_CERT_REQ_INFO_R_CERT_REQ_CTX R_CERT_REQ_CTX **  


R_CERT_REQ_INFO_VERSION_STRING char **  


R_CERT_REQ_INFO_SIGNATURE_TYPE int *  


R_CERT_REQ_INFO_SIGNATURE_DIGEST_TYPE int *  


R_CERT_REQ_INFO_KEY_USAGE_INT int *

See Key Usage Extensions for valid values. 

 



The following table details the data types to pass into value when calling R_CERT_REQ_set_info(). 



 
Identifier set_info Data Type  


R_CERT_REQ_INFO_VERSION int *  


R_CERT_REQ_INFO_SUBJECT R_TITEM *  


R_CERT_REQ_INFO_PUBLIC_KEY R_TITEM *  


R_CERT_REQ_INFO_ATTRIBUTES R_TITEM *  


R_CERT_REQ_INFO_TO_BE_SIGNED R_TITEM *  


R_CERT_REQ_INFO_SIGNATURE R_TITEM *  


R_CERT_REQ_INFO_ALL R_TITEM *  


R_CERT_REQ_INFO_KEY_USAGE_INT int *

See Key Usage Extensions for valid values.  


R_CERT_REQ_INFO_SUBJECT_R_CERT_NAME R_CERT_NAME *  


R_CERT_REQ_INFO_R_PKEY R_PKEY * 

 



Defines


#define R_CERT_REQ_INFO_VERSION


 Indicates the version of the certificate request structure. More...



#define R_CERT_REQ_INFO_SUBJECT


 Indicates the name that is bound to the public key in the resulting certificate. More...



#define R_CERT_REQ_INFO_PUBLIC_KEY


 Indicates the public key around which the requestor wants to create a certificate. More...



#define R_CERT_REQ_INFO_ATTRIBUTES


 Indicates the attributes of the certificate request. More...



#define R_CERT_REQ_INFO_TO_BE_SIGNED


 Indicates the part of the certificate request that is signed. More...



#define R_CERT_REQ_INFO_SIGNATURE


 Indicates the signature that authenticates the contents of the certificate request. More...



#define R_CERT_REQ_INFO_ALL


 Indicates the certificate request data used when specifying what to digest. More...



#define R_CERT_REQ_INFO_TYPE


 Indicates the type of certificate request. More...



#define R_CERT_REQ_INFO_R_CERT_REQ_CTX


 Indicates the certificate request context associated with the certificate request. More...



#define R_CERT_REQ_INFO_VERSION_STRING


 Indicates the version string of the certificate request. More...



#define R_CERT_REQ_INFO_SIGNATURE_TYPE


 Indicates the signature type of the certificate. More...



#define R_CERT_REQ_INFO_SIGNATURE_DIGEST_TYPE


 Indicates the signature digest type of the certificate. More...



#define R_CERT_REQ_INFO_R_PKEY


 Indicates the public key of the certificate request as an R_PKEY. More...



#define R_CERT_REQ_INFO_SUBJECT_R_CERT_NAME


 Indicates the subject name of the certificate request as an R_CERT_NAME. More...



#define R_CERT_REQ_INFO_PARAMETERS


 Indicates a number of parameters together. More...



#define R_CERT_REQ_INFO_KEY_USAGE_INT


 Indicates the key usage of the certificate request. More...





Define Documentation





  

    
      

        

           #define R_CERT_REQ_INFO_ALL
      

    		
  





  

    
       
    
    



Indicates the certificate request data used when specifying what to digest. The following table details the usage of the identifier in Processing Functions. 



 
Function Value Data Type Description  


R_CERT_REQ_get_info() R_TITEM * Returns a reference to the complete certificate requests data. One of:

 
  • type - the type of certificate request data. 
  • data - the certificate request data. 
  • len - the length of the certificate request data.  
    • 

    R_CERT_REQ_set_info() R_TITEM * Passes the complete certificate request data to copy into the certificate request. One of:
    
 
  • type - the type of certificate request data. 
  • data - the certificate request data. 
  • len - the length of the certificate request data. 
    • 
     
    		
  
    

    

    

    
  
    
    
      
    
        
    
           #define R_CERT_REQ_INFO_ATTRIBUTES
      
    
        		
  
    

    

    
  
    
    
       
    
    


    
Indicates the attributes of the certificate request. The following table details the usage of the identifier in Processing Functions. 
    

    
 
    Function Value Data Type Description  
    

    R_CERT_REQ_get_info() R_TITEM * Returns a reference to the attribute data. One of:
    
 
  • type - the type of the attribute data. 
  • data - the attribute data. 
  • len - the length of the attribute data.  
    • 

    R_CERT_REQ_set_info() R_TITEM * Passes the attribute data to copy into the certificate request. One of:
    
 
  • type - the type of the attribute data. 
  • data - the attribute data. 
  • len - the length of the attribute data. 
    • 
     
    		
  
    

    

    

    
  
    
    
      
    
        
    
           #define R_CERT_REQ_INFO_KEY_USAGE_INT
      
    
        		
  
    

    

    
  
    
    
       
    
    


    
Indicates the key usage of the certificate request. The following table details the usage of the identifier in Processing Functions. 
    

    
 
    Function Value Data Type Description  
    

    R_CERT_REQ_get_info() int * Returns the key usage of the certificate request structure.  
    

    R_CERT_REQ_set_info() int * Passes a pointer to the key usage of the certificate request. 
    


    
The values of each bit in the integer are defined in Key Usage Extensions.     
    		
  
    

    

    

    
  
    
    
      
    
        
    
           #define R_CERT_REQ_INFO_PARAMETERS
      
    
        		
  
    

    

    
  
    
    
       
    
    


    
Indicates a number of parameters together. When calling R_CM_get_info() an array of R_ID_INFO structures is passed in with each info_id specifying the requested information. The corresponding information is placed against the value associated with the information identifier.
    
Parameters: 
    

    

    value
[In] A pointer to an array of R_ID_INFO. 
    

    value->info_id
[In] The information identifier.
    
 See Information Identifiers for valid values. 
    

    value->value
[Out] The information corresponding to the identifier. 
    

    

    When calling R_CM_set_info(), an array of R_ID_INFO structures is passed in with each info_id specifying what information to set. The information in value is set.
    
Parameters: 
    

    

    value
[In] A pointer to an array of R_ID_INFO. 
    

    value->info_id
[In] The information identifier.
    
 See Information Identifiers for valid values. 
    

    value->value
[In] The information corresponding to the identifier. 
    

    

            		
  
    

    

    

    
  
    
    
      
    
        
    
           #define R_CERT_REQ_INFO_PUBLIC_KEY
      
    
        		
  
    

    

    
  
    
    
       
    
    


    
Indicates the public key around which the requestor wants to create a certificate. The following table details the usage of the identifier in Processing Functions. 
    

    
 
    Function Value Data Type Description  
    

    R_CERT_REQ_get_info() R_TITEM * Returns a reference to the public key data. One of:
    
 
  • type - the type of the public key data. 
  • data - the public key data. 
  • len - the length of the public key data.  
    • 

    R_CERT_REQ_set_info() R_TITEM * Passes the public key data to copy into the certificate request. One of:
    
 
  • type - the type of the public key data. 
  • data - the public key data. 
  • len - the length of the public key data. 
    • 
     
    		
  
    

    

    

    
  
    
    
      
    
        
    
           #define R_CERT_REQ_INFO_R_CERT_REQ_CTX
      
    
        		
  
    

    

    
  
    
    
       
    
    


    
Indicates the certificate request context associated with the certificate request. The following table details the usage of the identifier in Processing Functions. 
    

    
 
    Function Value Data Type Description  
    

    R_CERT_REQ_get_info() R_CERT_REQ_CTX ** Returns a reference to the certificate request context that created the certificate request structure. 
    
     
    		
  
    

    

    

    
  
    
    
      
    
        
    
           #define R_CERT_REQ_INFO_R_PKEY
      
    
        		
  
    

    

    
  
    
    
       
    
    


    
Indicates the public key of the certificate request as an R_PKEY. The following table details the usage of the identifier in Processing Functions. 
    

    
 
    Function Value Data Type Description  
    

    R_CERT_REQ_get_info() R_PKEY ** Returns the public key of the certificate request structure.  
    

    R_CERT_REQ_set_info() R_PKEY * Passes a pointer to the new public key for the certificate request. 
    
     
    		
  
    

    

    

    
  
    
    
      
    
        
    
           #define R_CERT_REQ_INFO_SIGNATURE
      
    
        		
  
    

    

    
  
    
    
       
    
    


    
Indicates the signature that authenticates the contents of the certificate request. The following table details the usage of the identifier in Processing Functions. 
    

    
 
    Function Value Data Type Description  
    

    R_CERT_REQ_get_info() R_TITEM * Returns a reference to the signature data. One of:
    
 
  • type - the type of signature data. 
  • data - the signature data. 
  • len - the length of the signature data.  
    • 

    R_CERT_REQ_set_info() R_TITEM * Passes the signature data to copy into the certificate request. One of:
    
 
  • type - the type of signature data. 
  • data - the signature data. 
  • len - the length of the signature data. 
    • 
     
    		
  
    

    

    

    
  
    
    
      
    
        
    
           #define R_CERT_REQ_INFO_SIGNATURE_DIGEST_TYPE
      
    
        		
  
    

    

    
  
    
    
       
    
    


    
Indicates the signature digest type of the certificate. The following table details the usage of the identifier in Processing Functions. 
    

    
 
    Function Value Data Type Description  
    

    R_CERT_REQ_get_info() int * Returns the signature digest type. The value is one of the Algorithm Identifiers. 
    
     
    		
  
    

    

    

    
  
    
    
      
    
        
    
           #define R_CERT_REQ_INFO_SIGNATURE_TYPE
      
    
        		
  
    

    

    
  
    
    
       
    
    


    
Indicates the signature type of the certificate. The following table details the usage of the identifier in Processing Functions. 
    

    
 
    Function Value Data Type Description  
    

    R_CERT_REQ_get_info() int * Returns the signature type. The value is one of the Algorithm Identifiers. 
    
     
    		
  
    

    

    

    
  
    
    
      
    
        
    
           #define R_CERT_REQ_INFO_SUBJECT
      
    
        		
  
    

    

    
  
    
    
       
    
    


    
Indicates the name that is bound to the public key in the resulting certificate. The following table details the usage of the identifier in Processing Functions. 
    

    
 
    Function Value Data Type Description  
    

    R_CERT_REQ_get_info() R_TITEM * Returns a reference to the subject name data. One of:
    
 
  • type - the type of the subject name data. 
  • data - the subject name data. 
  • len - the length of the subject name data.  
    • 

    R_CERT_REQ_set_info() R_TITEM * Passes the subject name data to copy into the certificate request. One of:
    
 
  • type - the type of the subject name data. 
  • data - the subject name data. 
  • len - the length of the subject name data. 
    • 
     
    		
  
    

    

    

    
  
    
    
      
    
        
    
           #define R_CERT_REQ_INFO_SUBJECT_R_CERT_NAME
      
    
        		
  
    

    

    
  
    
    
       
    
    


    
Indicates the subject name of the certificate request as an R_CERT_NAME. The following table details the usage of the identifier in Processing Functions. 
    

    
 
    Function Value Data Type Description  
    

    R_CERT_REQ_get_info() R_CERT_NAME ** Returns the subject name of the certificate request structure.  
    

    R_CERT_REQ_set_info() R_CERT_NAME * Passes a pointer to the new subject name for the certificate request. 
    
     
    		
  
    

    

    

    
  
    
    
      
    
        
    
           #define R_CERT_REQ_INFO_TO_BE_SIGNED
      
    
        		
  
    

    

    
  
    
    
       
    
    


    
Indicates the part of the certificate request that is signed. The following table details the usage of the identifier in Processing Functions. 
    

    
 
    Function Value Data Type Description  
    

    R_CERT_REQ_get_info() R_TITEM * Returns a reference to the part of the certificate request to sign. One of:
    
 
  • type - the type of data to sign. 
  • data - the data to sign. 
  • len - the length of data to sign.  
    • 

    R_CERT_REQ_set_info() R_TITEM * Passes the part of a certificate request to sign and copy into the certificate request. One of: 
    
 
  • type - the type of data to sign. 
  • data - the data to sign. 
  • len - the length of data to sign. 
    • 
     
    		
  
    

    

    

    
  
    
    
      
    
        
    
           #define R_CERT_REQ_INFO_TYPE
      
    
        		
  
    

    

    
  
    
    
       
    
    


    
Indicates the type of certificate request. The following table details the usage of the identifier in Processing Functions. 
    

    
 
    Function Value Data Type Description  
    

    R_CERT_REQ_get_info() R_CERT_TYPE * Returns a reference to the type of certificate request. 
    
     
    		
  
    

    

    

    
  
    
    
      
    
        
    
           #define R_CERT_REQ_INFO_VERSION
      
    
        		
  
    

    

    
  
    
    
       
    
    


    
Indicates the version of the certificate request structure. The following table details the usage of the identifier in Processing Functions. 
    

    
 
    Function Value Data Type Description  
    

    R_CERT_REQ_get_info() int * Returns the version of the certificate request structure.  
    

    R_CERT_REQ_set_info() int * Passes a pointer to the version of the certificate request. 
    
     
    		
  
    

    

    

    
  
    
    
      
    
        
    
           #define R_CERT_REQ_INFO_VERSION_STRING
      
    
        		
  
    

    

    
  
    
    
       
    
    


    
Indicates the version string of the certificate request. The following table details the usage of the identifier in Processing Functions. 
    

    
 
    Function Value Data Type Description  
    

    R_CERT_REQ_get_info() char ** Returns a reference to a string representing the version. 
    
     
    		
  
    

    


    

Copyright (c) 1999-2005 RSA Security Inc. All rights reserved.
072-001001-2100-001-000 - 2.1