RSA BSAFE Cert-C
API Reference

TYPED_STRING Reference

A convenient structure that holds a typed string.

It can be used as either a standard attribute or an extension attribute in an OR_ADDRESS structure (which can be used as the alternate name in an ALTERNATE_NAME structure).

In the standard attributes structure, STANDARD_ATTRIBUTES, three fields are represented by a TYPED_STRING structure: countryName, administrationDomainName, and privateDomainName. It is also necessary to set the corresponding flag in validFields. See STANDARD_ATTRIBUTES for more information.
In the extension-attribute structure, EXTENSION_ATTRIBUTE, two fields are represented by a TYPED_STRING structure. If either EA_POSTAL_CODE or EA_PHYSICAL_DELIVERY_COUNTRY_NAME is set as the extension-attribute type, complete a TYPED_STRING structure to specify the extension-attribute value.

Data Fields

type

An unsigned int value that indicates the character type of the string in value. Set one of the following ASN.1 Value Tags, defined in the asn1pub.h header file, to identify the character type:

ASN.1 Value Tag	Character Type
`VT_UTF8_STRING`	UTF-8 string
`VT_NUMERIC_STRING`	Numeric string
`VT_PRINTABLE_STRING`	Printable string
`VT_T61_STRING`	Teletex 61 string
`VT_IA5_STRING`	IA5 string
`VT_BMP_STRING`	BMP string
`VT_UNIVERSAL_STRING`	Universal string

value An ITEM structure whose data member points to the string value and whose len member is the string length in bytes.

#include <certext.h>

00087 typedef struct TYPED_STRING {
00088   unsigned int  type;           /* the character type for the string */
00089   ITEM          value;          /* string length and value in bytes */
00090 } TYPED_STRING;

The documentation for this struct was generated from the following file:

certext.h

RSA BSAFE^® Cert-C 2.7 API Reference