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