Compartilhar via


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