Función CertRDNValueToStrA (wincrypt.h)

  • Artículo

La función CertRDNValueToStr convierte un nombre en un CERT_RDN_VALUE_BLOB en una cadena de caracteres terminada en 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 una CERT_RDN_VALUE_BLOB de un tipo adecuado para 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 NULL de terminación.

Valor devuelto

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

Comentarios

Si psz no es NULL y csz no es cero, el valor psz devuelto siempre es una cadena terminada en NULL posiblemente vacía.

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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2003 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino Windows
Encabezado wincrypt.h
Library Crypt32.lib
Archivo DLL Crypt32.dll

Consulte también

CertNameToStr

Funciones de conversión de datos