Compartir a través de


estructura CERT_RDN_ATTR (wincrypt.h)

La estructura CERT_RDN_ATTR contiene un único atributo de un nombre distintivo relativo (RDN). Un RDN completo se expresa en una estructura CERT_RDN que contiene una matriz de estructuras de CERT_RDN_ATTR .

Sintaxis

typedef struct _CERT_RDN_ATTR {
  LPSTR               pszObjId;
  DWORD               dwValueType;
  CERT_RDN_VALUE_BLOB Value;
} CERT_RDN_ATTR, *PCERT_RDN_ATTR;

Miembros

pszObjId

Identificador de objeto (OID) para el tipo del atributo definido en esta estructura. Este miembro puede ser uno de los siguientes OID.

Valor Significado
szOID_AUTHORITY_REVOCATION_LIST
Atributo de seguridad.
szOID_BUSINESS_CATEGORY
Cadena que no distingue mayúsculas de minúsculas. Atributo explicativo.
szOID_CA_CERTIFICATE
Atributo de seguridad.
szOID_CERTIFICATE_REVOCATION_LIST
Atributo de seguridad.
szOID_COMMON_NAME
Cadena que no distingue mayúsculas de minúsculas. Atributo de etiquetado.
szOID_COUNTRY_NAME
Cadena imprimible de dos caracteres. Atributo geográfico.
szOID_CROSS_CERTIFICATE_PAIR
Atributo de seguridad.
szOID_DESCRIPTION
Cadena que no distingue mayúsculas de minúsculas. Atributo explicativo.
szOID_DESTINATION_INDICATOR
Cadena imprimible. Atributo de direccionamiento de telecomunicaciones.
szOID_DEVICE_SERIAL_NUMBER
Cadena imprimible. Atributo de etiquetado.
szOID_DOMAIN_COMPONENT
Cadena IA5. Componente de nombre DNS, como "com".
szOID_FACSIMILE_TELEPHONE_NUMBER
Atributo de direccionamiento de telecomunicaciones.
szOID_GIVEN_NAME
Cadena que no distingue mayúsculas de minúsculas. Atributo name.
szOID_INITIALS
Cadena que no distingue mayúsculas de minúsculas. Atributo name.
szOID_INTERNATIONAL_ISDN_NUMBER
Cadena numérica. Atributo de direccionamiento de telecomunicaciones.
szOID_LOCALITY_NAME
Cadena que no distingue mayúsculas de minúsculas. Atributo geográfico.
szOID_MEMBER
Atributo de aplicación relacional.
szOID_ORGANIZATION_NAME
Cadena que no distingue mayúsculas de minúsculas. Atributo organizativo.
szOID_ORGANIZATIONAL_UNIT_NAME
Cadena que no distingue mayúsculas de minúsculas. Atributo organizativo.
szOID_OWNER
Atributo de aplicación relacional.
szOID_PHYSICAL_DELIVERY_OFFICE_NAME
Cadena que no distingue mayúsculas de minúsculas. Atributo de direccionamiento postal.
szOID_PKCS_12_FRIENDLY_NAME_ATTR
Atributo PKCS #12.
szOID_PKCS_12_LOCAL_KEY_ID
Atributo PKCS #12.
szOID_POST_OFFICE_BOX
Cadena que no distingue mayúsculas de minúsculas. Atributo de direccionamiento postal.
szOID_POSTAL_ADDRESS
Cadena imprimible. Atributo de direccionamiento postal.
szOID_POSTAL_CODE
Cadena que no distingue mayúsculas de minúsculas. Atributo de direccionamiento postal.
szOID_PREFERRED_DELIVERY_METHOD
Atributo de preferencia.
szOID_PRESENTATION_ADDRESS
Atributo de aplicación OSI.
szOID_REGISTERED_ADDRESS
Atributo de direccionamiento de telecomunicaciones.
szOID_ROLE_OCCUPANT
Atributo de aplicación relacional.
szOID_RSA_emailAddr
Cadena IA5. Email atributo.
szOID_SEARCH_GUIDE
Atributo explicativo.
szOID_SEE_ALSO
Atributo de aplicación relacional.
szOID_STATE_OR_PROVINCE_NAME
Cadena que no distingue mayúsculas de minúsculas. Atributo geográfico.
szOID_STREET_ADDRESS
Cadena que no distingue mayúsculas de minúsculas. Atributo geográfico.
szOID_SUPPORTED_APPLICATION_CONTEXT
Atributo de aplicación OSI.
szOID_SUR_NAME
Cadena que no distingue mayúsculas de minúsculas. Atributo de etiquetado.
szOID_TELEPHONE_NUMBER
Atributo de direccionamiento de telecomunicaciones.
szOID_TELETEXT_TERMINAL_IDENTIFIER
Atributo de direccionamiento de telecomunicaciones.
szOID_TELEX_NUMBER
Atributo de direccionamiento de telecomunicaciones.
szOID_TITLE
Cadena que no distingue mayúsculas de minúsculas. Atributo organizativo.
szOID_USER_CERTIFICATE
Atributo de seguridad.
szOID_USER_PASSWORD
Atributo de seguridad.
szOID_X21_ADDRESS
Cadena numérica. Atributo de direccionamiento de telecomunicaciones.

dwValueType

Indica la interpretación del miembro Value .

Este miembro puede ser uno de los valores siguientes.

Valor Significado
CERT_RDN_ANY_TYPE
El miembro pszObjId determina el tipo y la longitud asumidos.
CERT_RDN_BMP_STRING
Matriz de caracteres Unicode (16 bits).
CERT_RDN_ENCODED_BLOB
Blob de datos codificados.
CERT_RDN_GENERAL_STRING
No se usa actualmente.
CERT_RDN_GRAPHIC_STRING
No se usa actualmente.
CERT_RDN_IA5_STRING
Cadena arbitraria de caracteres IA5 (ASCII).
CERT_RDN_INT4_STRING
Matriz de elementos INT4 (32 bits).
CERT_RDN_ISO646_STRING
Un juego de 128 caracteres (8 bits).
CERT_RDN_NUMERIC_STRING
Solo los caracteres de 0 a 9 y el carácter de espacio (8 bits).
CERT_RDN_OCTET_STRING
Cadena arbitraria de octetos (8 bits).
CERT_RDN_PRINTABLE_STRING
Cadena arbitraria de caracteres imprimibles (8 bits).
CERT_RDN_T61_STRING
Cadena arbitraria de caracteres T.61 (8 bits).
CERT_RDN_TELETEX_STRING
Cadena arbitraria de caracteres T.61 (8 bits)
CERT_RDN_UNICODE_STRING
Matriz de caracteres Unicode (16 bits).
CERT_RDN_UNIVERSAL_STRING
Matriz de elementos INT4 (32 bits).
CERT_RDN_UTF8_STRING
Matriz de caracteres Unicode de 16 bits UTF8 codificados en la conexión como una secuencia de uno, dos o tres caracteres de ocho bits.
CERT_RDN_VIDEOTEX_STRING
Cadena arbitraria de caracteres de texto de vídeo.
CERT_RDN_VISIBLE_STRING
Un juego de 95 caracteres (8 bits).
 

Las marcas siguientes se pueden combinar mediante una operación OR bit a bit en el miembro dwValueType .

Valor Significado
CERT_RDN_DISABLE_CHECK_TYPE_FLAG
Para codificación. Cuando se establece, los caracteres no se comprueban para determinar si son válidos para el tipo de valor.
CERT_RDN_DISABLE_IE4_UTF8_FLAG
Para descodificar. De forma predeterminada, CERT_RDN_T61_STRING valores codificados se descodifican inicialmente como UTF8. Si se produce un error en la descodificación UTF8, el valor se descodifica como caracteres de 8 bits. Si se establece esta marca, omite el intento inicial de descodificar como UTF8 y descodifica el valor como caracteres de 8 bits.
CERT_RDN_ENABLE_T61_UNICODE_FLAG
Para codificación. Cuando se establece, si todos los caracteres Unicode son <= 0xFF, se selecciona el valor de CERT_RDN_T61_STRING en lugar del valor de CERT_RDN_UNICODE_STRING .
CERT_RDN_ENABLE_UTF8_UNICODE_FLAG
Para codificación. Cuando se establece, las cadenas se codifican con el valor CERT_RDN_UTF8_STRING en lugar del valor de CERT_RDN_UNICODE_STRING .
CERT_RDN_FORCE_UTF8_UNICODE_FLAG
Para codificación. Cuando se establece, las cadenas se codifican con el valor de CERT_RDN_UTF8_STRING en lugar de CERT_RDN_PRINTABLE_STRING valor para los tipos DirectoryString. Además, CERT_RDN_ENABLE_UTF8_UNICODE_FLAG está habilitado.

Windows Vista, Windows Server 2003 y Windows XP: Esta marca no se admite.

CERT_RDN_ENABLE_PUNYCODE_FLAG
Para codificación. Si la cadena contiene un RDN de correo electrónico y la dirección de correo electrónico está codificada en Punycode, la dirección de correo electrónico resultante se codifica como IA5String. La codificación punycode del nombre de host se realiza por etiqueta.

Para descodificar. Si el nombre contiene un RDN de correo electrónico y la parte local o el nombre de host de la dirección de correo electrónico contiene una IA5String codificada con Punycode, el valor de cadena RDN se convierte en su equivalente Unicode.

Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP: Esta marca no se admite.

Value

Un CERT_RDN_VALUE_BLOB que contiene el valor del atributo. El miembro cbData de Value es la longitud, en bytes, del miembro pbData . No es el número de elementos de la cadena pbData .

Por ejemplo, DWORD tiene una longitud de 32 bits o 4 bytes. Si pbData es una matriz DWORD , cbData sería cuatro veces el número de elementos DWORD de la matriz. Un SHORT tiene una longitud de 16 bits o 2 bytes. Si pbData es una matriz de elementos SHORT , cbData debe ser dos veces la longitud de la matriz.

El miembro pbData de Value puede ser una matriz terminada en null de 8 o 16 bits o una matriz de elementos de longitud fija. Si dwValueType se establece en CERT_RDN_ENCODED_BLOB, pbData se codifica.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado wincrypt.h

Consulte también

CERT_RDN

CRYPT_INTEGER_BLOB

CertIsRDNAttrsInCertificateName