Compartir a través de


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

Consulte también

CertEnroll Interfaces

IDispatch

Nombres de sujeto