estrutura CERT_RDN_ATTR (wincrypt.h)

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