Función CryptBinaryToStringA (wincrypt.h)

Artículo
11/20/2024

La función CryptBinaryToString convierte una matriz de bytes en una cadena con formato.

Sintaxis

BOOL CryptBinaryToStringA(
  [in]            const BYTE *pbBinary,
  [in]            DWORD      cbBinary,
  [in]            DWORD      dwFlags,
  [out, optional] LPSTR      pszString,
  [in, out]       DWORD      *pcchString
);

Parámetros

[in] pbBinary

Puntero a la matriz de bytes que se va a convertir en una cadena.

[in] cbBinary

Número de elementos de la matriz pbBinary de .

[in] dwFlags

Especifica el formato de la cadena con formato resultante. Este parámetro puede ser uno de los siguientes valores.

Valor	Significado
CRYPT_STRING_BASE64HEADER 0x00000000	Base64, con encabezados iniciales y finales del certificado.
CRYPT_STRING_BASE64 0x00000001	Base64, sin encabezados.
CRYPT_STRING_BINARY 0x00000002	Copia binaria pura.
CRYPT_STRING_BASE64REQUESTHEADER 0x00000003	Base64, con encabezados iniciales y finales de solicitud.
CRYPT_STRING_HEX 0x00000004	Solo hexadecimal.
CRYPT_STRING_HEXASCII 0x00000005	Hexadecimal, con presentación de caracteres ASCII.
CRYPT_STRING_BASE64X509CRLHEADER 0x00000009	Base64, con X.509 encabezados CRL iniciales y finales.
CRYPT_STRING_HEXADDR 0x0000000a	Hexadecimal, con presentación de direcciones.
CRYPT_STRING_HEXASCIIADDR 0x0000000b	Hexadecimal, con el carácter ASCII y la presentación de direcciones.
CRYPT_STRING_HEXRAW 0x0000000c	Cadena hexadecimal sin formato. Windows Server 2003 y Windows XP: Este valor no se admite.
CRYPT_STRING_BASE64URI 0x0000000d	Base64, sin encabezados, con "+" reemplazado por "-" y "/" reemplazado por "_", tal como se define en la sección 5 de RFC 4648.
CRYPT_STRING_STRICT 0x20000000	Aplique la descodificación estricta de formatos de texto ASN.1. Algunos BLOBS binarios ASN.1 pueden tener los primeros bytes del BLOB interpretados incorrectamente como texto base64. En este caso, se omite el resto del texto. Use esta marca para aplicar la descodificación completa del BLOB. Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP: Este valor no se admite.

Además de los valores anteriores, se puede especificar uno o varios de los valores siguientes para modificar el comportamiento de la función.

Valor	Significado
CRYPT_STRING_NOCRLF 0x40000000	No anexe caracteres de línea nuevos a la cadena codificada. El comportamiento predeterminado es usar un par de retorno de carro/avance de línea (CR/LF) (0x0D/0x0A) para representar una nueva línea. Windows Server 2003 y Windows XP: Este valor no se admite.
CRYPT_STRING_NOCR 0x80000000	Use solo el carácter de fuente de líneas (LF) (0x0A) para una nueva línea. El comportamiento predeterminado es usar un par CR/LF (0x0D/0x0A) para representar una nueva línea.

[out, optional] pszString

Puntero a un búfer que recibe la cadena convertida. Para calcular el número de caracteres que se deben asignar para contener la cadena devuelta, establezca este parámetro en NULL. La función colocará el número necesario de caracteres, incluida la terminación carácter de NULL, en el valor al que apunta pcchString.

[in, out] pcchString

Puntero a una variable DWORD de que contiene el tamaño, en TCHAR, del búfer de pszString. Si pszString es NULL, la función calcula la longitud de la cadena de retorno (incluido el carácter NULO de terminación) en TCHARs y la devuelve en este parámetro. Si pszString no es NULL y lo suficientemente grande, la función convierte los datos binarios en un formato de cadena especificado, incluido el carácter nulo de terminación, pero pcchString recibe la longitud en TCHARs, no incluido el carácter nulo de terminación.

Valor devuelto

Si la función se ejecuta correctamente, la función devuelve un valor distinto de cero (TRUE).

Si se produce un error en la función, devuelve cero (FALSE).

Observaciones

A excepción de cuando se usa CRYPT_STRING_BINARY codificación, todas las cadenas se anexan con una nueva secuencia de líneas. De forma predeterminada, la nueva secuencia de líneas es un par CR/LF (0x0D/0x0A). Si el parámetro dwFlags contiene la marca CRYPT_STRING_NOCR, la nueva secuencia de líneas es un carácter LF (0x0A). Si el parámetro dwFlags contiene la marca CRYPT_STRING_NOCRLF, no se anexa ninguna secuencia de línea nueva a la cadena.

Nota

El encabezado wincrypt.h define CryptBinaryToString 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

CryptStringToBinary

Compartir a través de