RSA BSAFE Cert-C

Certificate Components for C

Crypto-C 6.2.1 Developer's Guide
Search

altname.h File Reference

This file creates, frees, encodes, and decodes GENERAL_NAME structures.

#include "basetype.h"
#include "certext.h"

Go to the source code of this file.

Functions

int C_CopyGeneralName (GENERAL_NAME *newGenName, GENERAL_NAME *oldGenName)
 Copies all of the members of an old GENERAL_NAME structure into a new GENERAL_NAME structure. More...

void C_FreeGeneralName (GENERAL_NAME *genName)
 Frees all the memory associated with the members of a GENERAL_NAME data structure. More...

int C_BERDecodeGeneralName (CERTC_CTX ctx, unsigned char *inputBER, unsigned int inputLen, GENERAL_NAME *genName)
 Decodes a BER-encoded GENERAL_NAME value into a GENERAL_NAME data structure. More...

int C_DEREncodeGeneralName (CERTC_CTX ctx, GENERAL_NAME *genName, unsigned char **outputDER, unsigned int *outputLen)
 DER encodes a GENERAL_NAME data structure into the equivalent ASN.1 data type. More...

Function Documentation

int C_BERDecodeGeneralName (  CERTC_CTX    ctx,
unsigned char *    inputBER,
unsigned int    inputLen,
GENERAL_NAME *    altName
)  ;
 

Decodes a BER-encoded GENERAL_NAME value into a GENERAL_NAME data structure. The caller must allocate memory for the GENERAL_NAME structure itself, but does not need to allocate memory to hold the members of the GENERAL_NAME structure. The caller is responsible for freeing the memory associated with the GENERAL_NAME structure itself, and should call C_FreeGeneralName() to free the memory used by the members of the GENERAL_NAME structure.

Parameters:
ctx [In] The Cert-C context.
inputBER [In] A pointer to the BER-encoded GENERAL_NAME value.
inputLen [In] The length, in Bytes, of the encoding.
altName [Out] A pointer to a pre-allocated GENERAL_NAME structure that contains the decoded information.
Returns:
0 indicates success.
See Errors for error information.

int C_CopyGeneralName (  GENERAL_NAME *    newGenName,
GENERAL_NAME *    oldGenName
)  ;
 

Copies all of the members of an old GENERAL_NAME structure into a new GENERAL_NAME structure. It is necessary to pre-allocate the GENERAL_NAME structure that will hold the new general name, but it is not necessary to pre-allocate the members of the structure that will hold the new general name.

Parameters:
newGenName [Out] A pointer to the new copy of the GENERAL_NAME structure. It is necessary to pre-allocate this structure, but it is not necessary to pre-allocate the members of the structure.
oldGenName [In] A pointer to the GENERAL_NAME structure to copy.
Returns:
0 indicates success.
See Errors for error information.

int C_DEREncodeGeneralName (  CERTC_CTX    ctx,
GENERAL_NAME *    altName,
unsigned char **    outputDER,
unsigned int *    outputLen
)  ;
 

DER encodes a GENERAL_NAME data structure into the equivalent ASN.1 data type. The application can call T_free() to free the buffer returned in outputDER.

Parameters:
ctx [In] The Cert-C context.
altName [In] A pointer to the GENERAL_NAME structure to be encoded.
outputDER [Out] A pointer to a dynamically allocated output buffer in which the DER encoding is returned.
outputLen [Out] A pointer to the length, in Bytes, of the encoding.
Returns:
0 indicates success.
See Errors for error information.
Samples:
pkiutil.c, and roleattrib.c.

void C_FreeGeneralName (  GENERAL_NAME *    altName )  ;
 

Frees all the memory associated with the members of a GENERAL_NAME data structure. It does not free the GENERAL_NAME structure itself.

Parameters:
altName [In, Out] A pointer to a GENERAL_NAME structure in memory.
Returns:
0 indicates success.
See Errors for error information.

Copyright (c) 1999-2005 RSA Security Inc. All rights reserved. 067-001001-2720-001-000 - 2.7.2