Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This structure contains a single attribute of a relative distinguished name (RDN). A whole RDN is expressed in a CERT_RDNstructure that contains an array of CERT_RDN_ATTRstructures.

Syntax 

typedef struct _CERT_RDN_ATTR {
  LPSTR 
pszObjId;
  DWORD 
dwValueType;
  CERT_RDN_VALUE_BLOB 
Value;
} CERT_RDN_ATTR, *PCERT_RDN_ATTR;

Members

pszObjId

Object identifier (OID) for the type of the attribute defined in this structure. The following table shows defined OIDs.

Object identifier Description

szOID_COMMON_NAME

Labeling attribute.

Case-insensitive string.

szOID_SUR_NAME

Case-insensitive string.

Labeling attribute.

szOID_DEVICE_SERIAL_NUMBER

Printable string.

Labeling attribute.

szOID_COUNTRY_NAME

Two-character printable string.

Geographic attribute.

szOID_LOCALITY_NAME

Case-insensitive string.

Geographic attribute.

szOID_STATE_OR_PROVINCE_NAME

Case-insensitive string.

Geographic attribute.

szOID_STREET_ADDRESS

Case-insensitive string.

Geographic attribute.

szOID_ORGANIZATION_NAME

Case-insensitive string.

Organizational attribute.

szOID_ORGANIZATIONAL_UNIT_NAME

Case-insensitive string.

Organizational attribute.

szOID_TITLE

Case-insensitive string.

Organizational attribute.

szOID_DESCRIPTION

Case-insensitive string.

Explanatory attribute.

szOID_SEARCH_GUIDE

Explanatory attribute.

szOID_BUSINESS_CATEGORY

Case-insensitive string.

Explanatory attribute.

szOID_POSTAL_ADDRESS

Printable string.

Postal addressing attribute.

szOID_POSTAL_CODE

Case-insensitive string.

Postal addressing attribute.

szOID_POST_OFFICE_BOX

Case-insensitive string.

Postal addressing attribute.

szOID_PHYSICAL_DELIVERY_OFFICE_NAME

Case-insensitive string.

Postal addressing attribute.

szOID_TELEPHONE_NUMBER

Telecommunications addressing attribute.

szOID_TELEX_NUMBER

Telecommunications addressing attribute.

szOID_TELETEXT_TERMINAL_IDENTIFIER

Telecommunications addressing attribute.

szOID_FACSIMILE_TELEPHONE_NUMBER

Telecommunications addressing attribute.

szOID_X21_ADDRESS

Numeric string.

Telecommunications addressing attribute.

szOID_INTERNATIONAL_ISDN_NUMBER

Numeric string.

Telecommunications addressing attribute.

szOID_REGISTERED_ADDRESS

Telecommunications addressing attribute.

szOID_DESTINATION_INDICATOR

Printable string.

Telecommunications addressing attribute.

szOID_PREFERRED_DELIVERY_METHOD

Preference attribute.

szOID_PRESENTATION_ADDRESS

OSI application attribute.

szOID_SUPPORTED_APPLICATION_CONTEXT

OSI application attribute.

szOID_MEMBER

Relational application attribute.

szOID_OWNER

Relational application attribute.

szOID_ROLE_OCCUPANT

Relational application attribute.

szOID_SEE_ALSO

Relational application attribute.

szOID_USER_PASSWORD

Security attribute.

szOID_USER_CERTIFICATE

Security attribute.

szOID_CA_CERTIFICATE

Security attribute.

szOID_AUTHORITY_REVOCATION_LIST

Security attribute.

szOID_CERTIFICATE_REVOCATION_LIST

Security attribute.

szOID_CROSS_CERTIFICATE_PAIR

Security attribute.

szOID_GIVEN_NAME

Case-insensitive string.

Name attribute.

szOID_INITIALS

Case-insensitive string.

Name attribute.

szOID_RSA_emailAddr

IA5 string.

E-mail attribute.

szOID_DOMAIN_COMPONENT

IA5 string. DNS name part such as com.

szOID_PKCS_12_FRIENDLY_NAME_ATTR

PKCS 12 attribute.

szOID_PKCS_12_LOCAL_KEY_ID

PKCS 12 attribute.
dwValueType

Interpretation of the Valuemember. The following table shows defined values for the dwValueTypemember and describes the corresponding structure of the Valuemember.

Value Description

CERT_RDN_ANY_TYPE

The pszObjIdmember determines the assumed type and length.

CERT_RDN_ENCODED_BLOB

An encoded data BLOB.

CERT_RDN_OCTET_STRING

An arbitrary string of octets (8-bit).

CERT_RDN_GRAPHIC_STRING

Currently not used.

CERT_RDN_GENERAL_STRING

Currently not used.

CERT_RDN_NUMERIC_STRING

Only the characters 0 through 9 and the space character (8-bit).

CERT_RDN_PRINTABLE_STRING

An arbitrary string of printable characters (8-bit).

CERT_RDN_TELETEX_STRING

An arbitrary string of T.61 characters (8-bit).

CERT_RDN_T61_STRING

An arbitrary string of T.61 characters (8-bit).

CERT_RDN_VIDEOTEX_STRING

An arbitrary string of videotex characters.

CERT_RDN_IA5_STRING

An arbitrary string of IA5 (ASCII) characters.

CERT_RDN_VISIBLE_STRING

A 95-character set (8-bit).

CERT_RDN_ISO646_STRING

A 128-character set (8-bit).

CERT_RDN_UNIVERSAL_STRING

An array of INT4 elements (32-bit).

CERT_RDN_INT4_STRING

An array of INT4 elements (32-bit).

CERT_RDN_BMP_STRING

An array of Unicode characters (16-bit).

CERT_RDN_UNICODE_STRING

An array of Unicode characters (16-bit).

CERT_RDN_UTF8_STRING

An array of 16 bit Unicode characters UTF8 encoded on the wire as a sequence of one, two, or three 8-bit characters.

The following table shows flags that can be combined with a bitwise ORoperation into the dwValueTypemember.

Value Description

CERT_RDN_ENABLE_T61_UNICODE_FLAG

For encoding. When set, if all the Unicode characters are <= 0xFF, the CERT_RDN_T61_STRING is selected instead of the CERT_RDN_UNICODE_STRING.

CERT_RDN_DISABLE_CHECK_TYPE_FLAG

For encoding. When set, the characters are not checked to see if they are valid for the value type.

CERT_RDN_DISABLE_IE4_UTF8_FLAG

For decoding. By default, CERT_RDN_T61_STRING encoded values are initially decoded as UTF8. If the UTF8 decoding fails, the value is decoded as 8-bit characters. If this flag is set, it skips the initial attempt to decode as UTF8 and decodes the value as 8-bit characters.
Value

BLOB (Cryptography)structure containing the attribute value. The cbDatamember of Valueis the length in bytes of the pbDatamember. It is not the number of elements in the pbDatastring.

For example, a DWORDis 32 bits or 4 bytes long. If pbDatais a pointer to a DWORDarray, cbDatawould be four times the number of DWORDelements in the array. A shortis 16 bits or 2 bytes long. If pbDatais an array of shortelements, cbDatamust be two times the length of the array.

The pbDatamember of Valuecan be a null-terminated array of 8-bit or 16-bit characters or a fixed length array of elements. If dwValueTypeis set to CERT_RDN_ENCODED_BLOB, pbDatais encoded.

Requirements

Header wincrypt.h
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also