Compartir a través de

Función CertRDNValueToStrA (wincrypt.h)

  • Artículo

La función CertRDNValueToStr convierte un nombre en un CERT_RDN_VALUE_BLOB en una cadena de caracteresnull null.

Sintaxis

DWORD CertRDNValueToStrA(
  [in]  DWORD                dwValueType,
  [in]  PCERT_RDN_VALUE_BLOB pValue,
  [out] LPSTR                psz,
  [in]  DWORD                csz
);

Parámetros

[in] dwValueType

Indica el tipo de valor RDN que se va a convertir.

Puede ser uno de los siguientes valores:

  • CERT_RDN_ANY_TYPE
  • CERT_RDN_ENCODED_BLOB
  • CERT_RDN_OCTET_STRING
  • CERT_RDN_NUMERIC_STRING
  • CERT_RDN_PRINTABLE_STRING
  • CERT_RDN_TELETEX_STRING
  • CERT_RDN_T61_STRING
  • CERT_RDN_VIDEOTEX_STRING
  • CERT_RDN_IA5_STRING
  • CERT_RDN_GRAPHIC_STRING
  • CERT_RDN_VISIBLE_STRING
  • CERT_RDN_ISO646_STRING
  • CERT_RDN_GENERAL_STRING
  • CERT_RDN_UNIVERSAL_STRING
  • CERT_RDN_INT4_STRING
  • CERT_RDN_BMP_STRING
  • CERT_RDN_UNICODE_STRING
  • CERT_RDN_UTF8_STRING

[in] pValue

Puntero a un CERT_RDN_VALUE_BLOB de un tipo adecuado para el dwValueType.

[out] psz

Puntero a un búfer para recibir la cadena devuelta.

[in] csz

Tamaño, en caracteres, asignado para la cadena devuelta. El tamaño debe incluir el carácter de de terminación NULL.

Valor devuelto

Devuelve el número de caracteres convertidos, incluida la terminación carácter NULL. Si psz es NULL o csz es cero, devuelve el tamaño necesario de la cadena de destino.

Observaciones

Si psz no es NULL y csz no es cero, el psz devuelto siempre es una cadena nulaterminada.

Nota

El encabezado wincrypt.h define CertRDNValueToStr como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito Valor
cliente mínimo admitido Windows XP [aplicaciones de escritorio | Aplicaciones para UWP]
servidor mínimo admitido Windows Server 2003 [aplicaciones de escritorio | Aplicaciones para UWP]
de la plataforma de destino de Windows
encabezado de wincrypt.h
biblioteca de Crypt32.lib
DLL de Crypt32.dll

Consulte también

CertNameToStr

funciones de conversión de datos de