RSA Security logo

RSA BSAFE Cert-C
API Reference

STANDARD_ATTRIBUTES Reference

When specifying an OR_ADDRESS structure (as a member of an ALTERNATE_NAME structure), use the STANDARD_ATTRIBUTES structure to store the standard attributes of the O/R Address.

Data Fields
validFields A UINT4 value that indicates which of the optional members of the structure are present. This field is set by 'OR'ing together the flags for each of the valid fields. Set the applicable flags from the following table to identify the valid fields:

Valid Field Description
SA_COUNTRY_NAME_VALID Country Name is valid.
SA_ADMIN_DOMAIN_NAME_VALID Administration Domain Name is valid.
SA_NETWORK_ADDRESS_VALID Network Address is valid.
SA_TERMINAL_ID_VALID Terminal Identifier is valid.
SA_PRIVATE_DOMAIN_VALID Private Domain Name is valid.
SA_ORGANIZATION_NAME_VALID Organizational Name is valid.
SA_NUMERIC_USER_ID_VALID Numeric User Identifier is valid.
SA_PERSON_NAME_VALID Personal Name is valid.
SA_ORG_UNIT_NAMES_VALID Organizational Unit Name is valid.

countryName A TYPED_STRING structure that represents a country name. Valid only if SA_COUNTRY_NAME_VALID is set in validFields. The type member indicates that the value member holds either a numeric string or a printable string. The maximum length for a numeric string is UB_CountryNameNumericLength. The maximum length for a printable string is UB_CountryNameAlphaLength.
administrationDomainName A TYPED_STRING structure that represents an administration domain name. Valid only if SA_ADMIN_DOMAIN_NAME_VALID is set in validFields. The type member indicates that the value member holds either a numeric string or a printable string. The maximum length is UB_DomainNameLength.
networkAddress An ITEM structure that represents a network address. Valid only if SA_NETWORK_ADDRESS_VALID is set in validFields. The data member points to a numeric string. The maximum length is UB_x121AddressLength.
terminalId An ITEM structure that represents a terminal identifier. Valid only if SA_TERMINAL_ID_VALID is set in validFields. The data member points to a printable string. The maximum length is UB_TerminalIdLength.
privateDomainName A TYPED_STRING structure that represents a private domain name. Valid only if SA_PRIVATE_DOMAIN_VALID is set in validFields. The type member indicates that the value member holds either a numeric string or a printable string. The maximum length is UB_DomainNameLength.
organizationName An ITEM structure that represents an organization name. Valid only if SA_ORGANIZATION_NAME_VALID is set in validFields. The data member points to a printable string. The maximum length is UB_OrganizationNameLength.
numericUserId An ITEM structure that represents a numeric user identifier. Valid only if SA_NUMERIC_USER_ID_VALID is set in validFields. The data member points to a numeric string. The maximum length is UB_NumericUserIdLength.
personalName A PERSONAL_NAME structure that represents a personal name. Valid only if SA_PERSONAL_NAME_VALID is set in validFields.
orgUnitNames An ORG_UNIT_NAMES structure that represents the organizational unit names. Valid only if SA_ORG_UNIT_NAMES_VALID is set in validFields.

#include <certext.h> 

01009 typedef struct STANDARD_ATTRIBUTES {
01010   UINT4         validFields;
01011   TYPED_STRING  countryName;  /* valid only if SA_COUNTRY_NAME_VALID is set in validFields */
01012                               /* points to numeric string or printable string */
01013                               /* Max length of the Data member is UB_CountryNameNumericLength
01014                                  for numeric string and UB_CountryNameAlphaLength for printable string */
01015   TYPED_STRING  administrationDomainName; /* valid only if SA_ADMIN_DOMAIN_NAME_VALID is set in validFields */
01016                               /* points to numeric string or printable string */
01017                               /* Max length of the Data member is UB_DomainNameLength */
01018   ITEM          networkAddress; /* valid only if SA_NETWORK_ADDRESS_VALID is set in validFields */
01019                               /* points to numeric string */
01020                               /* Max length of the Data member is UB_x121AddressLength */
01021   ITEM          terminalId;   /* valid only if SA_TERMINAL_ID_VALID is set in validFields */
01022                               /* points to printable string */
01023                               /* Max length of the Data member is UB_TerminalIdLength */
01024   TYPED_STRING  privateDomainName; /* valid only if SA_PRIVATE_DOMAIN_VALID is set in validFields */
01025                               /* points to numeric string or printable string */
01026                               /* Max length of the Data member is UB_DomainNameLength */
01027   ITEM          organizationName; /* valid only if SA_ORGANIZATION_NAME_VALID is set in validFields */
01028                               /* points to printable string */
01029                               /* Max length of the Data member is UB_OrganizationNameLength */
01030   ITEM          numericUserId;/* valid only if SA_NUMERIC_USER_ID_VALID is set in validFields */
01031                               /* points to numeric string */
01032                               /* Max length of the Data member is UB_NumericUserIdLength */
01033   PERSONAL_NAME personalName; /* valid only if SA_PERSON_NAME_VALID is set in validFields */
01034                               /* points to printable string */
01035   ORG_UNIT_NAMES orgUnitNames;/* valid only if SA_ORG_UNIT_NAMES_VALID is set in validFields */
01036                               /* points to printable string */
01037 } STANDARD_ATTRIBUTES;
The documentation for this struct was generated from the following file:

RSA BSAFE® Cert-C 2.7 API Reference