Interfaz IX500DistinguishedName (certenroll.h)
La interfaz IX500DistinguishedName representa un nombre distintivo X.500 (DN). La serie X.500 de estándares de red cubre los servicios de directorio electrónico. Un nombre distintivo identifica (distingue) de forma única cada entrada del directorio de todas las demás entradas. Cada DN consta de uno o varios nombres distintivos relativos (RDN).
El campo asunto de una solicitud de certificado PKCS #10 contiene el DN de la entidad que solicita el certificado.
CertificationRequestInfo ::= SEQUENCE
{
version CertificationRequestInfoVersion,
subject Name,
subjectPublicKeyInfo SubjectPublicKeyInfo,
attributes [0] IMPLICIT Attributes
}
El DN consta de una secuencia de RDN. Cada RDN consta de un conjunto de atributos y cada atributo consta de un identificador de objeto (OID) y un valor. El tipo de datos del valor se identifica mediante la estructura DirectoryString .
Name ::= SEQUENCE OF RelativeDistinguishedName
RelativeDistinguishedName ::= SET OF AttributeTypeValue
AttributeTypeValue ::= SEQUENCE
{
type EncodedObjectID,
value ANY
}
DirectoryString ::= CHOICE
{
teletexString TeletexString (SIZE (1..MAX)),
printableString PrintableString (SIZE (1..MAX)),
universalString UniversalString (SIZE (1..MAX)),
utf8String UTF8String (SIZE (1..MAX)),
bmpString BMPString (SIZE (1..MAX))
}
Actualmente se admiten las siguientes claves RDN y los OID asociados.
| Clave | OID | Descripción | Tipo de RDN |
|---|---|---|---|
| C | XCN_OID_COUNTRY_NAME | Contiene un código de país o región ISO 3166 de dos letras. | PrintableString |
| CN | XCN_OID_COMMON_NAME | Contiene un nombre común. | PrintableString |
| EEMAIL | XCN_OID_RSA_emailAddr | Contiene una dirección de correo electrónico. | IA5String |
| DC | XCN_OID_DOMAIN_COMPONENT | Contiene un componente de un nombre del sistema de nombres de dominio (DNS). | IA5String |
| GGivenName | XCN_OID_GIVEN_NAME | Contiene la parte del nombre de una persona que no es un apellido. | PrintableString |
| I | XCN_OID_INITIALS | Contiene las iniciales de una persona. | PrintableString |
| L | XCN_OID_LOCALITY_NAME | Contiene el nombre de la localidad que identifica una ciudad, un país u otra región geográfica. | PrintableString |
| O | XCN_OID_ORGANIZATION_NAME | Contiene el nombre de una organización. | PrintableString |
| OU | XCN_OID_ORGANIZATIONAL_UNIT_NAME | Contiene el nombre de una subdivisión de unidad dentro de una organización. | PrintableString |
| SST | XCN_OID_STATE_OR_PROVINCE_NAME | Contiene el nombre completo de un estado o provincia. | PrintableString |
| STREET | XCN_OID_STREET_ADDRESS | Contiene la dirección física. | PrintableString |
| SN | XCN_OID_SUR_NAME | Contiene el nombre de familia de una persona. | PrintableString |
| TTITLE | XCN_OID_TITLE | Contiene el título de una persona de la organización. | PrintableString |
Cada servicio basado en X.500 define su propia representación de cadena de nombre distintivo. Por ejemplo, LDAP usa una lista delimitada por comas organizada de derecha a izquierda. Active Directory usa una barra diagonal (/) y organiza la lista de izquierda a derecha. Otros servicios usan punto y coma como separadores. En el ejemplo siguiente se muestra una entrada de Active Directory para un empleado llamado John Peoples que trabaja en la división farmacéutica de una empresa denominada Contoso, Ltd.
/c=gb/o=Contoso Ltd./ou=Contoso Pharmaceuticals/cn=John Peoples
Herencia
La interfaz IX500DistinguishedName hereda de la interfaz IDispatch . IX500DistinguishedName también tiene estos tipos de miembros:
Métodos
La interfaz IX500DistinguishedName tiene estos métodos.
| IX500DistinguishedName::D ecode Inicializa el objeto a partir de un nombre distintivo codificado en Unicode. |
| IX500DistinguishedName::Encode Inicializa el objeto de una cadena que contiene un nombre distintivo. |
| IX500DistinguishedName::get_EncodedName Recupera un nombre distintivo con codificación Unicode. |
| IX500DistinguishedName::get_Name Recupera un nombre distintivo. |
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | certenroll.h |