CNG Algorithm Pseudo-handles
Beginning in Windows 10, CNG provides pre-defined algorithm handles for many algorithms. You can use these handles in any situation that requires an algorithm handle.
Hash and Message Authentication Code (MAC) Algorithms
| Constant | Description |
|---|---|
| BCRYPT_MD2_ALG_HANDLE | A handle for the MD2 hash algorithm. Standard: RFC 1319. |
| BCRYPT_MD4_ALG_HANDLE | A handle for the MD4 hash algorithm. Standard: RFC 1320. |
| BCRYPT_MD5_ALG_HANDLE | A handle for the MD5 hash algorithm. Standard: RFC 1321. |
| BCRYPT_SHA1_ALG_HANDLE | A handle for the 160-bit secure hash algorithm. Standard: FIPS 180-2, FIPS 198. |
| BCRYPT_SHA256_ALG_HANDLE | A handle for the 256-bit secure hash algorithm. Standard: FIPS 180-2, FIPS 198. |
| BCRYPT_SHA384_ALG_HANDLE | A handle for the 384-bit secure hash algorithm. Standard: FIPS 180-2, FIPS 198. |
| BCRYPT_SHA512_ALG_HANDLE | A handle for the 512-bit secure hash algorithm. Standard: FIPS 180-2, FIPS 198. |
| BCRYPT_HMAC_MD2_ALG_HANDLE | A handle for the hash-based message authentication code using the MD2 hash algorithm. Standard: RFC 2104, RFC 1319. |
| BCRYPT_HMAC_MD4_ALG_HANDLE | A handle for the hash-based message authentication code using the MD4 hash algorithm. Standard: RFC 2104, RFC 1320. |
| BCRYPT_HMAC_MD5_ALG_HANDLE | A handle for the hash-based message authentication code using the MD4 hash algorithm. Standard: RFC 2104, RFC 1321. |
| BCRYPT_HMAC_SHA1_ALG_HANDLE | A handle for the hash-based message authentication code using the 160-bit secure hash algorithm. Standard: RFC 2014, FIPS 180-2, FIPS 198. |
| BCRYPT_HMAC_SHA256_ALG_HANDLE | A handle for the hash-based message authentication code using the 256-bit secure hash algorithm. Standard: RFC 2014, FIPS 180-2, FIPS 198. |
| BCRYPT_HMAC_SHA384_ALG_HANDLE | A handle for the hash-based message authentication code using the 384-bit secure hash algorithm. Standard: RFC 2014, FIPS 180-2, FIPS 198. |
| BCRYPT_HMAC_SHA512_ALG_HANDLE | A handle for the hash-based message authentication code using the 512-bit secure hash algorithm. Standard: RFC 2014, FIPS 180-2, FIPS 198. |
Stream Cipher Algorithms
| Constant | Description |
|---|---|
| BCRYPT_RC4_ALG_HANDLE | A handle for the RC4 stream cipher algorithm. Standard: Various. |
Random Number Generator Algorithms
| Constant | Description |
|---|---|
| BCRYPT_RNG_ALG_HANDLE | A handle to the random-number generator algorithm.Note Beginning with Windows Vista with SP1 and Windows Server 2008, the random number generator is based on the AES counter mode specified in the NIST SP 800-90 standard. Windows Vista: The random number generator is based on the hash-based random number generator specified in the FIPS 186-2 standard. Windows 8: The RNG algorithm supports FIPS 186-3. Keys less than or equal to 1024 bits adhere to FIPS 186-2 and keys greater than 1024 to FIPS 186-3. |
| BCRYPT_RNG_FIPS186_DSA_ALG_HANDLE | A handle to the random-number generator algorithm suitable for DSA (Digital Signature Algorithm). Standard: FIPS 186-2. Windows 8: Support for FIPS 186-3 begins. |
Key Derivation Function (KDF) Algorithms
| Constant | Description |
|---|---|
| BCRYPT_CAPI_KDF_ALG_HANDLE | A handle to the Crypto API (CAPI) key derivation function algorithm. Used by the BCryptKeyDerivation and NCryptKeyDerivation functions. |
| BCRYPT_PBKDF2_ALG_HANDLE | A handle to the Password-based key derivation function 2 (PBKDF2) algorithm. Used by the BCryptKeyDerivation and NCryptKeyDerivation functions. |
| BCRYPT_SP800108_CTR_HMAC_ALG_HANDLE | A handle to the Counter mode, hash-based message authentication code (HMAC) key derivation function algorithm. Used by the BCryptKeyDerivation and NCryptKeyDerivation functions. |
| BCRYPT_SP80056A_CONCAT_ALG_HANDLE | A handle to the SP800-56A key derivation function algorithm. Used by the BCryptKeyDerivation and NCryptKeyDerivation functions. |
Asymmetric Algorithms
| Constant | Description |
|---|---|
| BCRYPT_DH_ALG_HANDLE | A handle to the Diffie-Hellman key exchange algorithm. Standard: PKCS #3. |
| BCRYPT_DSA_ALG_HANDLE | A handle to the Digital Signature Algorithm (DSA) digital signature algorithm. Standard: FIPS 186-2. Note: Beginning with Windows 8, this algorithm supports FIPS 186-3. Keys less than or equal to 1024 bits adhere to FIPS 186-2 and keys greater than 1024 to FIPS 186-3. |
| BCRYPT_ECDH_P256_ALG_HANDLE | A handle to the 256-bit prime elliptic curve Diffie-Hellman key exchange algorithm. Standard: SP800-56A. |
| BCRYPT_ECDH_P384_ALG_HANDLE | A handle to the 384-bit prime elliptic curve Diffie-Hellman key exchange algorithm. Standard: SP800-56A. |
| BCRYPT_ECDH_P521_ALG_HANDLE | A handle to the 521-bit prime elliptic curve Diffie-Hellman key exchange algorithm. Standard: SP800-56A. |
| BCRYPT_ECDSA_P256_ALG_HANDLE | A handle to the 256-bit prime elliptic curve digital signature algorithm (FIPS 186-2). Standard: FIPS 186-2, X9.62. |
| BCRYPT_ECDSA_P384_ALG_HANDLE | A handle to the 384-bit prime elliptic curve digital signature algorithm (FIPS 186-2). Standard: FIPS 186-2, X9.62 |
| BCRYPT_ECDSA_P521_ALG_HANDLE | A handle to the 521-bit prime elliptic curve digital signature algorithm (FIPS 186-2). Standard: FIPS 186-2, X9.62 |
| BCRYPT_RSA_ALG_HANDLE | A handle to the RSA public key algorithm. Standard: PKCS #1 v1.5 and v2.0. |
| BCRYPT_RSA_SIGN_ALG_HANDLE | A handle to the RSA signature algorithm. This algorithm is not currently supported. You can use the BCRYPT_RSA_ALG_HANDLE algorithm to perform RSA signing operations. Standard: PKCS #1 v1.5 and v2.0. |
Block Cipher and Cipher-based Message Authentication Code Algorithms
| Constant | Description |
|---|---|
| BCRYPT_3DES_CBC_ALG_HANDLE | A handle for the triple Data Encryption Standard algorithm using Cipher Block Chaining mode (CBC). Standard: SP800-67, SP800-38A. |
| BCRYPT_3DES_ECB_ALG_HANDLE | A handle for the triple Data Encryption Standard algorithm using Electronic Cookbook mode (ECB). Standard: SP800-67, SP800-38A. |
| BCRYPT_3DES_CFB_ALG_HANDLE | A handle for the triple Data Encryption Standard algorithm using Cipher Feedback mode (CFB). Standard: SP800-67, SP800-38A. |
| BCRYPT_3DES_112_CBC_ALG_HANDLE | A handle for the 112-bit triple Data Encryption Standard algorithm using Cipher Block Chaining mode (CBC). Standard: SP800-67, SP800-38A. |
| BCRYPT_3DES_112_CBC_ALG_HANDLE | A handle for the 112-bit triple Data Encryption Standard algorithm using Cipher Block Chaining mode (CBC). Standard: SP800-67, SP800-38A. |
| BCRYPT_3DES_112_ECB_ALG_HANDLE | A handle for the 112-bit triple Data Encryption Standard algorithm using Electronic Cookbook mode (ECB). Standard: SP800-67, SP800-38A. |
| BCRYPT_3DES_112_CFB_ALG_HANDLE | A handle for the 112-bit triple Data Encryption Standard algorithm using Cipher Feedback mode (CFB). Standard: SP800-67, SP800-38A. |
| BCRYPT_AES_CMAC_ALG_HANDLE | A handle for the Advanced Encryption standard (AES) cipher-based message authentication code (CMAC) algorithm. Standard: SP800-38B. |
| BCRYPT_AES_CBC_ALG_HANDLE | A handle for the Advanced Encryption Standard (AES) algorithm using Cipher Block Chaining Mode (CBC). Standard: FIPS 197. |
| BCRYPT_AES_ECB_ALG_HANDLE | A handle for the Advanced Encryption Standard (AES) algorithm using Electronic Cookbook Mode (ECB). Standard: FIPS 197. |
| BCRYPT_AES_CFB_ALG_HANDLE | A handle for the Advanced Encryption Standard (AES) algorithm using Cipher Feedback Mode (CFB). Standard: FIPS 197. |
| BCRYPT_AES_CCM_ALG_HANDLE | A handle for the Advanced Encryption Standard (AES) algorithm using Counter with CBC-MAC Mode (CCM). Standard: FIPS 197. |
| BCRYPT_AES_GCM_ALG_HANDLE | A handle for the Advanced Encryption Standard (AES) algorithm using Galois Counter Mode (GCM). Standard: FIPS 197. |
| BCRYPT_DES_CBC_ALG_HANDLE | A handle for the Data Encryption Standard (DES) algorithm using Cipher Block Chaining Mode (GCM). Standard: FIPS 46-3, FIPS 81. |
| BCRYPT_DES_ECB_ALG_HANDLE | A handle for the Data Encryption Standard (DES) algorithm using Electronic Cookbook Mode (ECB). Standard: FIPS 46-3, FIPS 81. |
| BCRYPT_DES_CFB_ALG_HANDLE | A handle for the Data Encryption Standard (DES) algorithm using Cipher Feedback Mode (CFB). Standard: FIPS 46-3, FIPS 81. |
| BCRYPT_3DES_ALG_HANDLE | A handle for the Triple Data Encryption Standard symmetric encryption algorithm. Standard: SP800-67, SP800-38A. |
| BCRYPT_3DES_112_ALG_HANDLE | A handle for the 112-bit Triple Data Encryption Standard symmetric encryption algorithm. Standard: SP800-67, SP800-38A. |
| BCRYPT_AES_ALG_HANDLE | A handle for the Advanced Encryption Standard (AES) symmetric encryption algorithm. Standard: FIPS 197. |
| BCRYPT_AES_CMAC_ALG_HANDLE | A handle for the Advanced Encryption Standard (AES) cipher based message authentication code (CMAC) symmetric encryption algorithm. Standard: SP 800-38B. Windows 8: Support for this algorithm begins. |
| BCRYPT_AES_GMAC_ALG_HANDLE | A handle for the Advanced Encryption Standard (AES) Galois message authentication code (GMAC) symmetric encryption algorithm. Standard: SP800-38D. Windows Vista SP1: Support for this algorithm begins. |
| BCRYPT_DES_ALG_HANDLE | A handle to the Data Encryption Standard (DES) symmetric encryption algorithm. Standard: FIPS 46-3, FIPS 81. |
| BCRYPT_DESX_ALG_HANDLE | A handle to the extended Data Encryption Standard (DES) symmetric encryption algorithm. Standard: None. |
| BCRYPT_RC2_ALG_HANDLE | A handle to the RC2 block symmetric encryption algorithm. Standard: RFC 2268. |
| BCRYPT_RC4_ALG_HANDLE | A handle to the RC4 symmetric encryption algorithm. Standard: Various |
Remarks
Beginning in Windows 10, CNG provides pre-defined algorithm handles for many algorithms. You can use these handles in any situation that requires an algorithm handle. However, any call to BCryptSetProperty fails as the algorithm handle is shared and cannot be modified. In addition, these handles cannot be used at IRQL=DISPATCH in kernel mode.
Related topics
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for