Interface IX500DistinguishedName (certenroll.h)

A interface IX500DistinguishedName representa um DN (nome diferenciado) X.500. A série X.500 de padrões de rede abrange serviços de diretório eletrônico. Um nome diferenciado identifica exclusivamente (distingue) cada entrada no diretório de todas as outras entradas. Cada DN consiste em um ou mais rdns (nomes distintos relativos).

O campo de assunto de uma solicitação de certificado PKCS #10 contém o DN da entidade que solicita o certificado

CertificationRequestInfo ::= SEQUENCE 
{
   version                 CertificationRequestInfoVersion,
   subject                 Name,
   subjectPublicKeyInfo    SubjectPublicKeyInfo,
   attributes              [0] IMPLICIT Attributes
}

O DN consiste em uma sequência de RDNs. Cada RDN consiste em um conjunto de atributos e cada atributo consiste em um OID ( identificador de objeto ) e um valor. O tipo de dados do valor é identificado pela estrutura 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)) 
}

No momento, há suporte para as seguintes chaves RDN e OIDs associadas.

Chave	OID	Descrição	Tipo RDN
C	XCN_OID_COUNTRY_NAME	Contém um código de região ou país ISO 3166 de duas letras.	PrintableString
CN	XCN_OID_COMMON_NAME	Contém um nome comum.	PrintableString
EEMAIL	XCN_OID_RSA_emailAddr	Contém um endereço de email.	IA5String
DC	XCN_OID_DOMAIN_COMPONENT	Contém um componente de um nome DNS (Sistema de Nomes de Domínio).	IA5String
GGivenName	XCN_OID_GIVEN_NAME	Contém a parte do nome de uma pessoa que não é um sobrenome.	PrintableString
I	XCN_OID_INITIALS	Contém as iniciais de uma pessoa.	PrintableString
L	XCN_OID_LOCALITY_NAME	Contém o nome da localidade que identifica uma cidade, um país ou outra região geográfica.	PrintableString
O	XCN_OID_ORGANIZATION_NAME	Contém o nome de uma organização.	PrintableString
OU	XCN_OID_ORGANIZATIONAL_UNIT_NAME	Contém o nome de uma subdivisão de unidade em uma organização.	PrintableString
SST	XCN_OID_STATE_OR_PROVINCE_NAME	Contém o nome completo de um estado ou província.	PrintableString
RUA	XCN_OID_STREET_ADDRESS	Contém o endereço físico.	PrintableString
SN	XCN_OID_SUR_NAME	Contém o nome da família de uma pessoa.	PrintableString
TTITLE	XCN_OID_TITLE	Contém o título de uma pessoa na organização.	PrintableString

 

Cada serviço baseado em X.500 define sua própria representação de cadeia de caracteres de nome diferenciada. Por exemplo, o LDAP usa uma lista delimitada por vírgulas organizada da direita para a esquerda. O Active Directory usa uma barra (/) e organiza a lista da esquerda para a direita. Outros serviços usam ponto e vírgula como separadores. O exemplo a seguir mostra uma entrada do Active Directory para um funcionário chamado John Peoples que trabalha na divisão farmacêutica de uma empresa chamada Contoso, Ltd.

/c=gb/o=Contoso Ltd./ou=Contoso Pharmaceuticals/cn=John Peoples

Herança

A interface IX500DistinguishedName herda da interface IDispatch . IX500DistinguishedName também tem esses tipos de membros:

Métodos

A interface IX500DistinguishedName tem esses métodos.

IX500DistinguishedName::D ecode Inicializa o objeto de um nome diferenciado codificado em Unicode.
IX500DistinguishedName::Encode Inicializa o objeto de uma cadeia de caracteres que contém um nome diferenciado.
IX500DistinguishedName::get_EncodedName Recupera um nome diferenciado codificado em Unicode.
IX500DistinguishedName::get_Name Recupera um nome diferenciado.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	certenroll.h

Confira também

CertEnroll Interfaces

IDispatch

Nomes de Entidades