Compartilhar via


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