Función CertStrToNameA (wincrypt.h)

La función CertStrToName convierte una cadena X.500 terminada en null en un nombre de certificado codificado.

Sintaxis

BOOL CertStrToNameA(
  [in]            DWORD  dwCertEncodingType,
  [in]            LPCSTR pszX500,
  [in]            DWORD  dwStrType,
  [in, optional]  void   *pvReserved,
  [out]           BYTE   *pbEncoded,
  [in, out]       DWORD  *pcbEncoded,
  [out, optional] LPCSTR *ppszError
);

Parámetros

[in] dwCertEncodingType

Tipo de codificación de certificado que se usó para codificar la cadena. Esta función omite el identificador de tipo de codificación de mensaje , contenido en el alto WORD de este valor.

Este parámetro puede ser el siguiente tipo de codificación de certificado definido actualmente.

[in] pszX500

Puntero a la cadena X.500 terminada en null que se va a convertir. El parámetro dwStrType especifica el formato de esta cadena.

Se espera que esta cadena tenga el mismo formato que la salida de la función CertNameToStr .

[in] dwStrType

Este parámetro especifica el tipo de la cadena. Este parámetro también especifica otras opciones para el contenido de la cadena.

Si no se combinan marcas con el especificador de tipo de cadena, la cadena puede contener una coma (,) o un punto y coma (;) como separadores en el nombre distintivo relativo (RDN) y un signo más (+) como separador en varios valores de RDN.

Se admiten comillas (""). Una comilla se puede incluir en un valor entrecomillado mediante dos conjuntos de comillas, por ejemplo, CN="User ""one""".

Un valor que comienza con un signo de número (#) se trata como hexadecimal ASCII y se convierte en un CERT_RDN_OCTET_STRING. Se omite el espacio en blanco incrustado. Por ejemplo, 1.2.3 = # AB CD 01 es el mismo que 1.2.3=#ABCD01.

Se omite el espacio en blanco que rodea las claves, los identificadores de objeto y los valores.

Este parámetro puede ser uno de los valores siguientes.

Las siguientes opciones también se pueden combinar con el valor anterior para especificar opciones adicionales para la cadena.

[in, optional] pvReserved

Reservado para uso futuro y debe ser NULL.

[out] pbEncoded

Puntero a un búfer que recibe la estructura codificada.

El tamaño de este búfer se especifica en el parámetro pcbEncoded .

Este parámetro puede ser NULL para obtener el tamaño necesario del búfer con fines de asignación de memoria. Para obtener más información, vea Recuperar datos de longitud desconocida.

[in, out] pcbEncoded

Puntero a un DWORD que, antes de llamar a la función, contiene el tamaño, en bytes, del búfer al que apunta el parámetro pbEncoded . Cuando la función devuelve, DWORD contiene el número de bytes almacenados en el búfer.

Si pbEncoded es NULL, DWORD recibe el tamaño, en bytes, necesario para el búfer.

[out, optional] ppszError

Puntero a un puntero de cadena que recibe información de error adicional sobre una cadena de entrada que no es válida.

Si la cadena pszX500 no es válida, ppszError se actualiza mediante esta función para que apunte al principio de la secuencia de caracteres que no es válida. Si no se detecta ningún error en la cadena de entrada, ppszError se establece en NULL.

Si esta información no es necesaria, pase NULL para este parámetro.

Este parámetro se actualiza para los siguientes códigos de error devueltos desde GetLastError.

CRYPT_E_INVALID_X500_STRING

CRYPT_E_INVALID_NUMERIC_STRING

CRYPT_E_INVALID_PRINTABLE_STRING

CRYPT_E_INVALID_IA5_STRING

Valor devuelto

Devuelve un valor distinto de cero si es correcto o cero de lo contrario.

Para obtener información de error extendida, llame a GetLastError.

Comentarios

La tabla siguiente contiene las claves X.500 admitidas, su cadena de identificador de objeto correspondiente, el identificador de cadena (de Wincrypt.h) y los tipos de valor.

Si se permite Imprimir o T61 como tipo de valor RDN para la clave, Printable se selecciona automáticamente si el componente de cadena de nombre es miembro de los siguientes conjuntos de caracteres:

• A, B, ..., Z
• a, b, ..., z
• 0, 1, ..., 9
• (espacio) ' ( ) + , - . / : = ?

Los tipos T61 están codificados en UTF8.

Ejemplos

Para ver un ejemplo que usa esta función, vea Programa C de ejemplo: Convertir nombres de certificados a ASN.1 y Atrás.

Requisitos

Consulte también

CertNameToStr

Funciones de conversión de datos

Obtener último error

Recuperar datos de longitud desconocida