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