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