A estrutura CERT_RDN_ATTR contém um único atributo de um RDN ( nome diferenciado relativo ). Um RDN inteiro é expresso em uma estrutura CERT_RDN que contém uma matriz de estruturas CERT_RDN_ATTR .
Sintaxe
typedef struct _CERT_RDN_ATTR {
LPSTR pszObjId;
DWORD dwValueType;
CERT_RDN_VALUE_BLOB Value;
} CERT_RDN_ATTR, *PCERT_RDN_ATTR;
Membros
pszObjId
OID (identificador de objeto ) para o tipo do atributo definido nessa estrutura. Esse membro pode ser um dos OIDs a seguir.
| Valor |
Significado |
-
szOID_AUTHORITY_REVOCATION_LIST
|
Atributo de segurança.
|
-
szOID_BUSINESS_CATEGORY
|
Cadeia de caracteres que não diferencia maiúsculas de minúsculas.
Atributo explicativo.
|
-
szOID_CA_CERTIFICATE
|
Atributo de segurança.
|
-
szOID_CERTIFICATE_REVOCATION_LIST
|
Atributo de segurança.
|
-
szOID_COMMON_NAME
|
Cadeia de caracteres que não diferencia maiúsculas de minúsculas.
Atributo de rotulagem.
|
-
szOID_COUNTRY_NAME
|
Cadeia de caracteres imprimível de dois caracteres.
Atributo geográfico.
|
-
szOID_CROSS_CERTIFICATE_PAIR
|
Atributo de segurança.
|
-
szOID_DESCRIPTION
|
Cadeia de caracteres que não diferencia maiúsculas de minúsculas. Atributo explicativo.
|
-
szOID_DESTINATION_INDICATOR
|
Cadeia de caracteres imprimível.
Atributo de endereçamento de telecomunicações.
|
-
szOID_DEVICE_SERIAL_NUMBER
|
Cadeia de caracteres imprimível.
Atributo de rotulagem.
|
-
szOID_DOMAIN_COMPONENT
|
Cadeia de caracteres IA5. Componente de nome DNS, como "com".
|
-
szOID_FACSIMILE_TELEPHONE_NUMBER
|
Atributo de endereçamento de telecomunicações.
|
-
szOID_GIVEN_NAME
|
Cadeia de caracteres que não diferencia maiúsculas de minúsculas.
Atributo de nome.
|
-
szOID_INITIALS
|
Cadeia de caracteres que não diferencia maiúsculas de minúsculas. Atributo de nome.
|
-
szOID_INTERNATIONAL_ISDN_NUMBER
|
Cadeia de caracteres numérica.
Atributo de endereçamento de telecomunicações.
|
-
szOID_LOCALITY_NAME
|
Cadeia de caracteres que não diferencia maiúsculas de minúsculas.
Atributo geográfico.
|
-
szOID_MEMBER
|
Atributo de aplicativo relacional.
|
-
szOID_ORGANIZATION_NAME
|
Cadeia de caracteres que não diferencia maiúsculas de minúsculas.
Atributo organizacional.
|
-
szOID_ORGANIZATIONAL_UNIT_NAME
|
Cadeia de caracteres que não diferencia maiúsculas de minúsculas.
Atributo organizacional.
|
-
szOID_OWNER
|
Atributo de aplicativo relacional.
|
-
szOID_PHYSICAL_DELIVERY_OFFICE_NAME
|
Cadeia de caracteres que não diferencia maiúsculas de minúsculas.
Atributo de endereçamento postal.
|
-
szOID_PKCS_12_FRIENDLY_NAME_ATTR
|
Atributo PKCS nº 12.
|
-
szOID_PKCS_12_LOCAL_KEY_ID
|
Atributo PKCS nº 12.
|
-
szOID_POST_OFFICE_BOX
|
Cadeia de caracteres que não diferencia maiúsculas de minúsculas.
Atributo de endereçamento postal.
|
-
szOID_POSTAL_ADDRESS
|
Cadeia de caracteres imprimível.
Atributo de endereçamento postal.
|
-
szOID_POSTAL_CODE
|
Cadeia de caracteres que não diferencia maiúsculas de minúsculas.
Atributo de endereçamento postal.
|
-
szOID_PREFERRED_DELIVERY_METHOD
|
Atributo de preferência.
|
-
szOID_PRESENTATION_ADDRESS
|
Atributo do aplicativo OSI.
|
-
szOID_REGISTERED_ADDRESS
|
Atributo de endereçamento de telecomunicações.
|
-
szOID_ROLE_OCCUPANT
|
Atributo de aplicativo relacional.
|
-
szOID_RSA_emailAddr
|
Cadeia de caracteres IA5.
Email atributo.
|
-
szOID_SEARCH_GUIDE
|
Atributo explicativo.
|
-
szOID_SEE_ALSO
|
Atributo de aplicativo relacional.
|
-
szOID_STATE_OR_PROVINCE_NAME
|
Cadeia de caracteres que não diferencia maiúsculas de minúsculas.
Atributo geográfico.
|
-
szOID_STREET_ADDRESS
|
Cadeia de caracteres que não diferencia maiúsculas de minúsculas.
Atributo geográfico.
|
-
szOID_SUPPORTED_APPLICATION_CONTEXT
|
Atributo do aplicativo OSI.
|
-
szOID_SUR_NAME
|
Cadeia de caracteres que não diferencia maiúsculas de minúsculas.
Atributo de rotulagem.
|
-
szOID_TELEPHONE_NUMBER
|
Atributo de endereçamento de telecomunicações.
|
-
szOID_TELETEXT_TERMINAL_IDENTIFIER
|
Atributo de endereçamento de telecomunicações.
|
-
szOID_TELEX_NUMBER
|
Atributo de endereçamento de telecomunicações.
|
-
szOID_TITLE
|
Cadeia de caracteres que não diferencia maiúsculas de minúsculas.
Atributo organizacional.
|
-
szOID_USER_CERTIFICATE
|
Atributo de segurança.
|
-
szOID_USER_PASSWORD
|
Atributo de segurança.
|
-
szOID_X21_ADDRESS
|
Cadeia de caracteres numérica.
Atributo de endereçamento de telecomunicações.
|
dwValueType
Indica a interpretação do membro Value .
Esse membro pode ser um dos valores a seguir.
| Valor |
Significado |
-
CERT_RDN_ANY_TYPE
|
O membro pszObjId determina o tipo e o comprimento assumidos.
|
-
CERT_RDN_BMP_STRING
|
Uma matriz de caracteres Unicode (16 bits).
|
-
CERT_RDN_ENCODED_BLOB
|
Um BLOB de dados codificado.
|
-
CERT_RDN_GENERAL_STRING
|
Não usado no momento.
|
-
CERT_RDN_GRAPHIC_STRING
|
Não usado no momento.
|
-
CERT_RDN_IA5_STRING
|
Uma cadeia de caracteres arbitrária de caracteres IA5 (ASCII).
|
-
CERT_RDN_INT4_STRING
|
Uma matriz de elementos INT4 (32 bits).
|
-
CERT_RDN_ISO646_STRING
|
Um conjunto de 128 caracteres (8 bits).
|
-
CERT_RDN_NUMERIC_STRING
|
Somente os caracteres de 0 a 9 e o caractere de espaço (8 bits).
|
-
CERT_RDN_OCTET_STRING
|
Uma cadeia de caracteres arbitrária de octetos (8 bits).
|
-
CERT_RDN_PRINTABLE_STRING
|
Uma cadeia de caracteres arbitrária de caracteres imprimíveis (8 bits).
|
-
CERT_RDN_T61_STRING
|
Uma cadeia de caracteres arbitrária de T.61 caracteres (8 bits).
|
-
CERT_RDN_TELETEX_STRING
|
Uma cadeia de caracteres arbitrária de caracteres T.61 (8 bits) |
-
CERT_RDN_UNICODE_STRING
|
Uma matriz de caracteres Unicode (16 bits).
|
-
CERT_RDN_UNIVERSAL_STRING
|
Uma matriz de elementos INT4 (32 bits).
|
-
CERT_RDN_UTF8_STRING
|
Uma matriz de caracteres Unicode de 16 bits UTF8 codificado no fio como uma sequência de um, dois ou três caracteres de oito bits.
|
-
CERT_RDN_VIDEOTEX_STRING
|
Uma cadeia de caracteres de videotexto arbitrária.
|
-
CERT_RDN_VISIBLE_STRING
|
Um conjunto de 95 caracteres (8 bits).
|
Os sinalizadores a seguir podem ser combinados usando uma operação OR bit a bit no membro dwValueType .
| Valor |
Significado |
-
CERT_RDN_DISABLE_CHECK_TYPE_FLAG
|
Para codificação. Quando definido, os caracteres não são verificados para determinar se são válidos para o tipo de valor.
|
-
CERT_RDN_DISABLE_IE4_UTF8_FLAG
|
Para decodificação. Por padrão, CERT_RDN_T61_STRING valores codificados são inicialmente decodificados como UTF8. Se a decodificação UTF8 falhar, o valor será decodificado como caracteres de 8 bits. Se esse sinalizador estiver definido, ele ignorará a tentativa inicial de decodificar como UTF8 e decodificará o valor como caracteres de 8 bits.
|
-
CERT_RDN_ENABLE_T61_UNICODE_FLAG
|
Para codificação. Quando definido, se todos os caracteres Unicode forem <= 0xFF, o valor CERT_RDN_T61_STRING será selecionado em vez do valor CERT_RDN_UNICODE_STRING .
|
-
CERT_RDN_ENABLE_UTF8_UNICODE_FLAG
|
Para codificação. Quando definidas, as cadeias de caracteres são codificadas com o valor CERT_RDN_UTF8_STRING em vez do valor CERT_RDN_UNICODE_STRING .
|
-
CERT_RDN_FORCE_UTF8_UNICODE_FLAG
|
Para codificação. Quando definidas, as cadeias de caracteres são codificadas com o valor CERT_RDN_UTF8_STRING em vez de CERT_RDN_PRINTABLE_STRING valor para tipos DirectoryString. Além disso, CERT_RDN_ENABLE_UTF8_UNICODE_FLAG está habilitado.
Windows Vista, Windows Server 2003 e Windows XP: Não há suporte para esse sinalizador.
|
-
CERT_RDN_ENABLE_PUNYCODE_FLAG
|
Para codificação. Se a cadeia de caracteres contiver um RDN de email e o endereço de email for codificado em Punycode, o endereço de email resultante será codificado como IA5String. A codificação punycode do nome do host é executada em uma base de rótulo por rótulo.
Para decodificação. Se o nome contiver um RDN de email e a parte local ou a parte do nome do host do endereço de email contiver um IA5String codificado em Punycode, o valor da cadeia de caracteres RDN será convertido em seu equivalente Unicode.
Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Não há suporte para esse sinalizador.
|
Value
Um CERT_RDN_VALUE_BLOB que contém o valor do atributo. O membro cbData de Value é o comprimento, em bytes, do membro pbData . Não é o número de elementos na cadeia de caracteres pbData .
Por exemplo, um DWORD tem 32 bits ou 4 bytes de comprimento. Se pbData for uma matriz DWORD , cbData será quatro vezes o número de elementos DWORD na matriz. Um SHORT tem 16 bits ou 2 bytes de comprimento. Se pbData for uma matriz de elementos SHORT , cbData deverá ter duas vezes o comprimento da matriz.
O membro pbData de Value pode ser uma matriz terminada em nulo de caracteres de 8 ou 16 bits ou uma matriz de elementos de comprimento fixo. Se dwValueType estiver definido como CERT_RDN_ENCODED_BLOB, pbData será codificado.
Requisitos
| Requisito |
Valor |
|
Cliente mínimo com suporte |
Windows XP [somente aplicativos da área de trabalho] |
|
Servidor mínimo com suporte |
Windows Server 2003 [somente aplicativos da área de trabalho] |
|
Cabeçalho |
wincrypt.h |
Confira também
CERT_RDN
CRYPT_INTEGER_BLOB
CertIsRDNAttrsInCertificateName