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 |