Función CryptStringToBinaryA (wincrypt.h)
La función
Sintaxis
BOOL CryptStringToBinaryA(
[in] LPCSTR pszString,
[in] DWORD cchString,
[in] DWORD dwFlags,
[in] BYTE *pbBinary,
[in, out] DWORD *pcbBinary,
[out] DWORD *pdwSkip,
[out] DWORD *pdwFlags
);
Parámetros
[in] pszString
Puntero a una cadena que contiene la cadena con formato que se va a convertir.
[in] cchString
Número de caracteres de la cadena con formato que se va a convertir, no incluida la terminación carácter NULL. Si este parámetro es cero, pszString se considera una cadena terminada en null.
[in] dwFlags
Indica el formato de la cadena que se va a convertir. Puede ser uno de los siguientes valores.
| Valor | Significado |
|---|---|
|
Base64 entre líneas del formulario "-----BEGIN ...-----" y "-----END ...-----". Vea los comentarios a continuación. |
|
Base64, sin encabezados. |
|
Copia binaria pura. |
|
Base64 entre líneas del formulario "-----BEGIN ...-----" y "-----END ...-----". Vea los comentarios a continuación. |
|
Solo formato hexadecimal. |
|
Formato hexadecimal con presentación de caracteres ASCII. |
|
Intenta lo siguiente, en orden:
|
|
Intenta lo siguiente, en orden:
|
|
Intenta lo siguiente, en orden:
|
|
Base64 entre líneas del formulario "-----BEGIN ...-----" y "-----END ...-----". Vea los comentarios a continuación. |
|
Hex, con presentación de direcciones. |
|
Hexadecimal, con el carácter ASCII y la presentación de direcciones. |
|
Cadena hexadecimal sin formato.
Windows Server 2003 y Windows XP: Este valor no se admite. |
|
Establezca esta marca para los datos Base64 para especificar que el final de los datos binarios solo contenga espacios en blanco y, como máximo, tres signos iguales a "=".
Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP: Este valor no se admite. |
[in] pbBinary
Puntero a un búfer que recibe la secuencia de bytes devuelta. Si este parámetro es
[in, out] pcbBinary
Puntero a una variable DWORD de
Si
[out] pdwSkip
Puntero a un valor DWORD que recibe el número de caracteres omitidos para llegar al principio del encabezado -----BEGIN ...-----.
Si no hay ningún encabezado presente, el
[out] pdwFlags
Puntero a un valor DWORD que recibe las marcas que se usan realmente en la conversión. Se trata de las mismas marcas que se usan para el parámetro dwFlags. En muchos casos, serán las mismas marcas que se pasaron en el parámetro dwFlags. Si dwFlags contiene una de las marcas siguientes, este valor recibirá una marca que indica el formato real de la cadena. Este parámetro es opcional y se puede NULL si no es necesario.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es distinto de cero (TRUE).
Si se produce un error en la función, el valor devuelto es cero (FALSE).
Observaciones
Las marcas CRYPT_STRING_BASE64HEADER, CRYPT_STRING_BASE64REQUESTHEADERy CRYPT_STRING_BASE64X509CRLHEADER se tratan de forma idéntica mediante esta función: intentan analizar el primer bloque de datos codificados en base64 entre líneas del formulario -----BEGIN ...----- y -----END ...-----.
Las partes ... se omiten y no necesitan coincidir.
Si el análisis se realiza correctamente, el valor pasado en el parámetro dwFlags
Nota
El encabezado wincrypt.h define CryptStringToBinary 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 |