Category

Development Platform
Home > SourceCode/Document > Crypt_Decrypt algrithms > View Code
bcrypt.h
Package: CNG-AES-source-code.rar　[view]
Upload User: jxhysc
Upload Date: 2007-08-26
Package Size: 12k
Code Size: 52k
Category:

Crypt_Decrypt algrithms

Development Platform:

Visual C++

bcrypt.h：Code Content
  1. //+---------------------------------------------------------------------------
  2. //
  3. //  Microsoft Windows
  4. //  Copyright (C) Microsoft Corporation, 2004.
  5. //
  6. //  File:       bcrypt.h
  7. //
  8. //  Contents:   Cryptographic Primitive API Prototypes and Definitions
  9. //
  10. //----------------------------------------------------------------------------
  12. #ifndef __BCRYPT_H__
  13. #define __BCRYPT_H__
  15. #ifdef __cplusplus
  16. extern "C" {
  17. #endif
  19. #ifndef WINAPI
  20. #define WINAPI __stdcall
  21. #endif
  23. #ifndef _NTDEF_
  24. typedef __success(return >= 0) LONG NTSTATUS, *PNTSTATUS;
  25. #endif
  27. #ifndef CONST
  28. #define CONST const
  29. #endif
  31. #ifndef IN
  32. #define IN
  33. #endif
  35. #ifndef OUT
  36. #define OUT
  37. #endif
  39. #ifndef OPTIONAL
  40. #define OPTIONAL
  41. #endif
  43. #if !defined(__midl)
  44. #define BCRYPT_STRUCT_ALIGNMENT __declspec(align(BCRYPT_OBJECT_ALIGNMENT))
  45. #else
  46. #define BCRYPT_STRUCT_ALIGNMENT
  47. #endif /*!defined(__midl)*/
  49. //
  50. //  Alignment macros
  51. //
  53. // BCRYPT_OBJECT_ALIGNMENT must be a power of 2
  54. #if defined(_IA64_) || defined(_AMD64_)
  55.  #define BCRYPT_OBJECT_ALIGNMENT    8
  56. #else
  57.  #define BCRYPT_OBJECT_ALIGNMENT    4
  58. #endif
  60. #if !defined(__midl)
  61. #define BCRYPT_STRUCT_ALIGNMENT __declspec(align(BCRYPT_OBJECT_ALIGNMENT))
  62. #else
  63. #define BCRYPT_STRUCT_ALIGNMENT
  64. #endif /*!defined(__midl)*/
  66. //
  67. // DeriveKey KDF Types
  68. //
  69. #define BCRYPT_KDF_HASH     L"HASH"
  70. #define BCRYPT_KDF_HMAC     L"HMAC"
  71. #define BCRYPT_KDF_TLS_PRF  L"TLS_PRF"
  73. //
  74. // DeriveKey KDF BufferTypes
  75. //
  76. // For BCRYPT_KDF_HASH and BCRYPT_KDF_HMAC operations, there may be an arbitrary
  77. // number of KDF_SECRET_PREPEND and KDF_SECRET_APPEND buffertypes in the
  78. // parameter list.  The BufferTypes are processed in order of appearence 
  79. // within the parameter list.
  80. //
  81. #define KDF_HASH_ALGORITHM  0x0
  82. #define KDF_SECRET_PREPEND  0x1
  83. #define KDF_SECRET_APPEND   0x2
  84. #define KDF_HMAC_KEY        0x3
  85. #define KDF_TLS_PRF_LABEL   0x4
  86. #define KDF_TLS_PRF_SEED    0x5
  87. #define KDF_SECRET_HANDLE   0x6
  89. //
  90. // DeriveKey Flags:
  91. //
  92. // KDF_USE_SECRET_AS_HMAC_KEY_FLAG causes the secret agreement to serve also
  93. // as the HMAC key.  If this flag is used, the KDF_HMAC_KEY parameter should 
  94. // NOT be specified.
  95. //
  96. #define KDF_USE_SECRET_AS_HMAC_KEY_FLAG 0x1
  98. //
  99. // BCrypt structs
  100. //
  102. typedef struct __BCRYPT_KEY_LENGTHS_STRUCT
  103. {
  104.     ULONG   dwMinLength;
  105.     ULONG   dwMaxLength;
  106.     ULONG   dwIncrement;
  107. } BCRYPT_KEY_LENGTHS_STRUCT;
  109. #pragma pack(push, BCRYPT_OBJECT_ALIGNMENT)
  110. typedef BCRYPT_STRUCT_ALIGNMENT struct _BCRYPT_OID
  111. {
  112.     ULONG   cbOID;
  113.     PUCHAR  pbOID;
  114. } BCRYPT_OID;
  116. typedef BCRYPT_STRUCT_ALIGNMENT struct _BCRYPT_OID_LIST
  117. {
  118.     ULONG       dwOIDCount;
  119.     BCRYPT_OID  *pOIDs;
  120. } BCRYPT_OID_LIST;
  121. #pragma pack(pop)
  123. typedef struct _BCRYPT_PKCS1_PADDING_INFO
  124. {
  125.     LPCWSTR pszAlgId;
  126. } BCRYPT_PKCS1_PADDING_INFO;
  128. typedef struct _BCRYPT_PSS_PADDING_INFO
  129. {
  130.     LPCWSTR pszAlgId;
  131.     ULONG   cbSalt;
  132. } BCRYPT_PSS_PADDING_INFO;
  134. typedef struct _BCRYPT_OAEP_PADDING_INFO
  135. {
  136.     LPCWSTR pszAlgId;
  137.     PUCHAR   pbLabel;
  138.     ULONG   cbLabel;
  139. } BCRYPT_OAEP_PADDING_INFO;
  141. #define BCRYPT_AUTHENTICATED_CIPHER_MODE_INFO_VERSION  1
  143. #define BCRYPT_AUTH_MODE_CHAIN_CALLS_FLAG   0x00000001
  144. #define BCRYPT_AUTH_MODE_IN_PROGRESS_FLAG   0x00000002
  146. typedef struct _BCRYPT_AUTHENTICATED_CIPHER_MODE_INFO
  147. {
  148.     ULONG   cbSize;
  149.     ULONG   dwInfoVersion;
  150.     PUCHAR  pbNonce;
  151.     ULONG   cbNonce;
  152.     PUCHAR  pbAuthData;
  153.     ULONG   cbAuthData;
  154.     PUCHAR  pbTag;
  155.     ULONG   cbTag;
  156.     PUCHAR  pbMacContext;
  157.     ULONG   cbMacContext;
  158.     ULONG   cbAAD;
  159.     ULONG   cbData;
  160.     ULONG   dwFlags;
  161. } BCRYPT_AUTHENTICATED_CIPHER_MODE_INFO, *PBCRYPT_AUTHENTICATED_CIPHER_MODE_INFO;
  163. #define BCRYPT_INIT_AUTH_MODE_INFO(_AUTH_INFO_STRUCT_)    
  164.             RtlZeroMemory((&_AUTH_INFO_STRUCT_), sizeof(BCRYPT_AUTHENTICATED_CIPHER_MODE_INFO));  
  165.             (_AUTH_INFO_STRUCT_).cbSize = sizeof(BCRYPT_AUTHENTICATED_CIPHER_MODE_INFO);          
  166.             (_AUTH_INFO_STRUCT_).dwInfoVersion = BCRYPT_AUTHENTICATED_CIPHER_MODE_INFO_VERSION;
  168. //
  169. // BCrypt String Properties
  170. //
  172. // BCrypt(Import/Export)Key BLOB types
  173. #define BCRYPT_OPAQUE_KEY_BLOB      L"OpaqueKeyBlob"
  174. #define BCRYPT_KEY_DATA_BLOB        L"KeyDataBlob"
  176. // BCryptGetProperty strings
  177. #define BCRYPT_OBJECT_LENGTH        L"ObjectLength"
  178. #define BCRYPT_ALGORITHM_NAME       L"AlgorithmName"
  179. #define BCRYPT_PROVIDER_HANDLE      L"ProviderHandle"
  180. #define BCRYPT_CHAINING_MODE        L"ChainingMode"
  181. #define BCRYPT_BLOCK_LENGTH         L"BlockLength"
  182. #define BCRYPT_KEY_LENGTH           L"KeyLength"
  183. #define BCRYPT_KEY_OBJECT_LENGTH    L"KeyObjectLength"
  184. #define BCRYPT_KEY_STRENGTH         L"KeyStrength"
  185. #define BCRYPT_KEY_LENGTHS          L"KeyLengths"
  186. #define BCRYPT_BLOCK_SIZE_LIST      L"BlockSizeList"
  187. #define BCRYPT_EFFECTIVE_KEY_LENGTH L"EffectiveKeyLength"
  188. #define BCRYPT_HASH_LENGTH          L"HashDigestLength"
  189. #define BCRYPT_HASH_OID_LIST        L"HashOIDList"
  190. #define BCRYPT_PADDING_SCHEMES      L"PaddingSchemes"
  191. #define BCRYPT_SIGNATURE_LENGTH     L"SignatureLength"
  192. #define BCRYPT_HASH_BLOCK_LENGTH    L"HashBlockLength"
  193. #define BCRYPT_AUTH_TAG_LENGTH      L"AuthTagLength"
  195. // BCryptSetProperty strings
  196. #define BCRYPT_INITIALIZATION_VECTOR    L"IV"
  199. // Property Strings
  200. #define BCRYPT_CHAIN_MODE_NA        L"ChainingModeN/A"
  201. #define BCRYPT_CHAIN_MODE_CBC       L"ChainingModeCBC"
  202. #define BCRYPT_CHAIN_MODE_ECB       L"ChainingModeECB"
  203. #define BCRYPT_CHAIN_MODE_CFB       L"ChainingModeCFB"
  204. #define BCRYPT_CHAIN_MODE_CCM       L"ChainingModeCCM"
  205. #define BCRYPT_CHAIN_MODE_GCM       L"ChainingModeGCM"
  207. // Supported RSA Padding Types
  208. #define BCRYPT_SUPPORTED_PAD_ROUTER     0x00000001
  209. #define BCRYPT_SUPPORTED_PAD_PKCS1_ENC  0x00000002
  210. #define BCRYPT_SUPPORTED_PAD_PKCS1_SIG  0x00000004
  211. #define BCRYPT_SUPPORTED_PAD_OAEP       0x00000008
  212. #define BCRYPT_SUPPORTED_PAD_PSS        0x00000010
  214. //
  215. //      BCrypt Flags
  216. //
  218. #define BCRYPT_PROV_DISPATCH        0x00000001  // BCryptOpenAlgorithmProvider
  220. #define BCRYPT_BLOCK_PADDING        0x00000001  // BCryptEncrypt/Decrypt
  222. // RSA padding schemes
  223. #define BCRYPT_PAD_NONE             0x00000001
  224. #define BCRYPT_PAD_PKCS1            0x00000002  // BCryptEncrypt/Decrypt BCryptSignHash/VerifySignature
  225. #define BCRYPT_PAD_OAEP             0x00000004  // BCryptEncrypt/Decrypt
  226. #define BCRYPT_PAD_PSS              0x00000008  // BCryptSignHash/VerifySignature
  229. #define BCRYPTBUFFER_VERSION        0
  231. typedef struct _BCryptBuffer {
  232.     ULONG   cbBuffer;             // Length of buffer, in bytes
  233.     ULONG   BufferType;           // Buffer type
  234.     PVOID   pvBuffer;             // Pointer to buffer
  235. } BCryptBuffer, * PBCryptBuffer;
  237. typedef struct _BCryptBufferDesc {
  238.     ULONG   ulVersion;            // Version number
  239.     ULONG   cBuffers;             // Number of buffers
  240.     PBCryptBuffer pBuffers;       // Pointer to array of buffers
  241. } BCryptBufferDesc, * PBCryptBufferDesc;
  244. //
  245. // Primitive handles
  246. //
  248. typedef PVOID BCRYPT_HANDLE;
  249. typedef PVOID BCRYPT_ALG_HANDLE;
  250. typedef PVOID BCRYPT_KEY_HANDLE;
  251. typedef PVOID BCRYPT_HASH_HANDLE;
  252. typedef PVOID BCRYPT_SECRET_HANDLE;
  255. //
  256. // Structures used to represent key blobs.
  257. //
  259. #define BCRYPT_PUBLIC_KEY_BLOB       L"PUBLICBLOB"
  260. #define BCRYPT_PRIVATE_KEY_BLOB      L"PRIVATEBLOB"
  262. typedef struct _BCRYPT_KEY_BLOB
  263. {
  264.     ULONG   Magic;
  265. } BCRYPT_KEY_BLOB;
  267. // The BCRYPT_RSAPUBLIC_BLOB and BCRYPT_RSAPRIVATE_BLOB blob types are used
  268. // to transport plaintext RSA keys. These blob types will be supported by
  269. // all RSA primitive providers.
  270. // The BCRYPT_RSAPRIVATE_BLOB includes the following values:
  271. // Public Exponent
  272. // Modulus
  273. // Prime1
  274. // Prime2
  276. #define BCRYPT_RSAPUBLIC_BLOB       L"RSAPUBLICBLOB"
  277. #define BCRYPT_RSAPRIVATE_BLOB      L"RSAPRIVATEBLOB"
  278. #define LEGACY_RSAPUBLIC_BLOB       L"CAPIPUBLICBLOB"
  279. #define LEGACY_RSAPRIVATE_BLOB      L"CAPIPRIVATEBLOB"
  281. #define BCRYPT_RSAPUBLIC_MAGIC      0x31415352  // RSA1
  282. #define BCRYPT_RSAPRIVATE_MAGIC     0x32415352  // RSA2
  284. typedef struct _BCRYPT_RSAKEY_BLOB
  285. {
  286.     ULONG   Magic;
  287.     ULONG   BitLength;
  288.     ULONG   cbPublicExp;
  289.     ULONG   cbModulus;
  290.     ULONG   cbPrime1;
  291.     ULONG   cbPrime2;
  292. } BCRYPT_RSAKEY_BLOB;
  294. // The BCRYPT_RSAFULLPRIVATE_BLOB blob type is used to transport
  295. // plaintext private RSA keys.  It includes the following values:
  296. // Public Exponent
  297. // Modulus
  298. // Prime1
  299. // Prime2
  300. // Private Exponent mod (Prime1 - 1)
  301. // Private Exponent mod (Prime2 - 1)
  302. // Inverse of Prime2 mod Prime1
  303. // PrivateExponent
  304. #define BCRYPT_RSAFULLPRIVATE_BLOB      L"RSAFULLPRIVATEBLOB"
  306. #define BCRYPT_RSAFULLPRIVATE_MAGIC     0x33415352  // RSA3
  308. // The BCRYPT_ECCPUBLIC_BLOB and BCRYPT_ECCPRIVATE_BLOB blob types are used
  309. // to transport plaintext ECC keys. These blob types will be supported by
  310. // all ECC primitive providers.
  311. #define BCRYPT_ECCPUBLIC_BLOB           L"ECCPUBLICBLOB"
  312. #define BCRYPT_ECCPRIVATE_BLOB          L"ECCPRIVATEBLOB"
  314. #define BCRYPT_ECDH_PUBLIC_P256_MAGIC   0x314B4345  // ECK1
  315. #define BCRYPT_ECDH_PRIVATE_P256_MAGIC  0x324B4345  // ECK2
  316. #define BCRYPT_ECDH_PUBLIC_P384_MAGIC   0x334B4345  // ECK3
  317. #define BCRYPT_ECDH_PRIVATE_P384_MAGIC  0x344B4345  // ECK4
  318. #define BCRYPT_ECDH_PUBLIC_P521_MAGIC   0x354B4345  // ECK5
  319. #define BCRYPT_ECDH_PRIVATE_P521_MAGIC  0x364B4345  // ECK6
  321. #define BCRYPT_ECDSA_PUBLIC_P256_MAGIC  0x31534345  // ECS1
  322. #define BCRYPT_ECDSA_PRIVATE_P256_MAGIC 0x32534345  // ECS2
  323. #define BCRYPT_ECDSA_PUBLIC_P384_MAGIC  0x33534345  // ECS3
  324. #define BCRYPT_ECDSA_PRIVATE_P384_MAGIC 0x34534345  // ECS4
  325. #define BCRYPT_ECDSA_PUBLIC_P521_MAGIC  0x35534345  // ECS5
  326. #define BCRYPT_ECDSA_PRIVATE_P521_MAGIC 0x36534345  // ECS6
  328. typedef struct _BCRYPT_ECCKEY_BLOB
  329. {
  330.     ULONG   dwMagic;
  331.     ULONG   cbKey;
  332. } BCRYPT_ECCKEY_BLOB, *PBCRYPT_ECCKEY_BLOB;
  334. // The BCRYPT_DH_PUBLIC_BLOB and BCRYPT_DH_PRIVATE_BLOB blob types are used
  335. // to transport plaintext DH keys. These blob types will be supported by
  336. // all DH primitive providers.
  337. #define BCRYPT_DH_PUBLIC_BLOB           L"DHPUBLICBLOB"
  338. #define BCRYPT_DH_PRIVATE_BLOB          L"DHPRIVATEBLOB"
  339. #define LEGACY_DH_PUBLIC_BLOB           L"CAPIDHPUBLICBLOB"
  340. #define LEGACY_DH_PRIVATE_BLOB          L"CAPIDHPRIVATEBLOB"
  342. #define BCRYPT_DH_PUBLIC_MAGIC          0x42504844  // DHPB
  343. #define BCRYPT_DH_PRIVATE_MAGIC         0x56504844  // DHPV
  345. typedef struct _BCRYPT_DH_KEY_BLOB
  346. {
  347.     ULONG   dwMagic;
  348.     ULONG   cbKey;
  349. } BCRYPT_DH_KEY_BLOB, *PBCRYPT_DH_KEY_BLOB;
  351. // Property Strings for DH
  352. #define BCRYPT_DH_PARAMETERS            L"DHParameters"
  354. #define BCRYPT_DH_PARAMETERS_MAGIC      0x4d504844  // DHPM
  356. typedef __struct_bcount(cbLength) struct _BCRYPT_DH_PARAMETER_HEADER
  357. {
  358.     ULONG           cbLength;
  359.     ULONG           dwMagic;
  360.     ULONG           cbKeyLength;
  361. } BCRYPT_DH_PARAMETER_HEADER;
  364. // The BCRYPT_DSA_PUBLIC_BLOB and BCRYPT_DSA_PRIVATE_BLOB blob types are used
  365. // to transport plaintext DSA keys. These blob types will be supported by
  366. // all DSA primitive providers.
  367. #define BCRYPT_DSA_PUBLIC_BLOB          L"DSAPUBLICBLOB"
  368. #define BCRYPT_DSA_PRIVATE_BLOB         L"DSAPRIVATEBLOB"
  369. #define LEGACY_DSA_PUBLIC_BLOB          L"CAPIDSAPUBLICBLOB"
  370. #define LEGACY_DSA_PRIVATE_BLOB         L"CAPIDSAPRIVATEBLOB"
  371. #define LEGACY_DSA_V2_PRIVATE_BLOB      L"V2CAPIDSAPRIVATEBLOB"
  373. #define BCRYPT_DSA_PUBLIC_MAGIC         0x42505344  // DSPB
  374. #define BCRYPT_DSA_PRIVATE_MAGIC        0x56505344  // DSPV
  376. typedef struct _BCRYPT_DSA_KEY_BLOB
  377. {
  378.     ULONG   dwMagic;
  379.     ULONG   cbKey;
  380.     UCHAR   Count[4];
  381.     UCHAR   Seed[20];
  382.     UCHAR   q[20];
  383. } BCRYPT_DSA_KEY_BLOB, *PBCRYPT_DSA_KEY_BLOB;
  385. typedef struct _BCRYPT_KEY_DATA_BLOB_HEADER
  386. {
  387.     ULONG   dwMagic;
  388.     ULONG   dwVersion;
  389.     ULONG   cbKeyData;
  390. } BCRYPT_KEY_DATA_BLOB_HEADER, *PBCRYPT_KEY_DATA_BLOB_HEADER;
  392. #define BCRYPT_KEY_DATA_BLOB_MAGIC       0x4d42444b //Key Data Blob Magic (KDBM)
  394. #define BCRYPT_KEY_DATA_BLOB_VERSION1    0x1
  396. // Property Strings for DSA
  397. #define BCRYPT_DSA_PARAMETERS       L"DSAParameters"
  399. #define BCRYPT_DSA_PARAMETERS_MAGIC 0x4d505344  // DSPM
  401. typedef struct _BCRYPT_DSA_PARAMETER_HEADER
  402. {
  403.     ULONG           cbLength;
  404.     ULONG           dwMagic;
  405.     ULONG           cbKeyLength;
  406.     UCHAR           Count[4];
  407.     UCHAR           Seed[20];
  408.     UCHAR           q[20];
  409. } BCRYPT_DSA_PARAMETER_HEADER;
  411. //
  412. // Microsoft built-in providers.
  413. //
  415. #define MS_PRIMITIVE_PROVIDER                   L"Microsoft Primitive Provider"
  417. //
  418. // Common algorithm identifiers.
  419. //
  421. #define BCRYPT_RSA_ALGORITHM                    L"RSA"
  422. #define BCRYPT_RSA_SIGN_ALGORITHM               L"RSA_SIGN"
  423. #define BCRYPT_DH_ALGORITHM                     L"DH"
  424. #define BCRYPT_DSA_ALGORITHM                    L"DSA"
  425. #define BCRYPT_RC2_ALGORITHM                    L"RC2"
  426. #define BCRYPT_RC4_ALGORITHM                    L"RC4"
  427. #define BCRYPT_AES_ALGORITHM                    L"AES"
  428. #define BCRYPT_DES_ALGORITHM                    L"DES"
  429. #define BCRYPT_DESX_ALGORITHM                   L"DESX"
  430. #define BCRYPT_3DES_ALGORITHM                   L"3DES"
  431. #define BCRYPT_3DES_112_ALGORITHM               L"3DES_112"
  432. #define BCRYPT_MD2_ALGORITHM                    L"MD2"
  433. #define BCRYPT_MD4_ALGORITHM                    L"MD4"
  434. #define BCRYPT_MD5_ALGORITHM                    L"MD5"
  435. #define BCRYPT_SHA1_ALGORITHM                   L"SHA1"
  436. #define BCRYPT_SHA256_ALGORITHM                 L"SHA256"
  437. #define BCRYPT_SHA384_ALGORITHM                 L"SHA384"
  438. #define BCRYPT_SHA512_ALGORITHM                 L"SHA512"
  439. #define BCRYPT_AES_GMAC_ALGORITHM               L"AES-GMAC"
  440. #define BCRYPT_ECDSA_P256_ALGORITHM             L"ECDSA_P256"
  441. #define BCRYPT_ECDSA_P384_ALGORITHM             L"ECDSA_P384"
  442. #define BCRYPT_ECDSA_P521_ALGORITHM             L"ECDSA_P521"
  443. #define BCRYPT_ECDH_P256_ALGORITHM              L"ECDH_P256"
  444. #define BCRYPT_ECDH_P384_ALGORITHM              L"ECDH_P384"
  445. #define BCRYPT_ECDH_P521_ALGORITHM              L"ECDH_P521"
  446. #define BCRYPT_RNG_ALGORITHM                    L"RNG"
  447. #define BCRYPT_RNG_FIPS186_DSA_ALGORITHM        L"FIPS186DSARNG"
  448. #define BCRYPT_RNG_DUAL_EC_ALGORITHM            L"DUALECRNG"
  450. //
  451. // Interfaces
  452. //
  454. #define BCRYPT_CIPHER_INTERFACE                 0x00000001
  455. #define BCRYPT_HASH_INTERFACE                   0x00000002
  456. #define BCRYPT_ASYMMETRIC_ENCRYPTION_INTERFACE  0x00000003
  457. #define BCRYPT_SECRET_AGREEMENT_INTERFACE       0x00000004
  458. #define BCRYPT_SIGNATURE_INTERFACE              0x00000005
  459. #define BCRYPT_RNG_INTERFACE                    0x00000006
  461. //
  462. // Primitive algorithm provider functions.
  463. //
  465. #define BCRYPT_ALG_HANDLE_HMAC_FLAG     0x00000008
  467. NTSTATUS
  468. WINAPI
  469. BCryptOpenAlgorithmProvider(
  470.     __out       BCRYPT_ALG_HANDLE   *phAlgorithm,
  471.     __in        LPCWSTR pszAlgId,
  472.     __in_opt    LPCWSTR pszImplementation,
  473.     __in        ULONG   dwFlags);
  475. typedef NTSTATUS
  476. (WINAPI * BCryptOpenAlgorithmProviderFn)(
  477.     __out   BCRYPT_ALG_HANDLE   *phAlgorithm,
  478.     __in    LPCWSTR pszAlgId,
  479.     __in    ULONG   dwFlags);
  482. // AlgOperations flags for use with BCryptEnumAlgorithms()
  483. #define BCRYPT_CIPHER_OPERATION                 0x00000001
  484. #define BCRYPT_HASH_OPERATION                   0x00000002
  485. #define BCRYPT_ASYMMETRIC_ENCRYPTION_OPERATION  0x00000004
  486. #define BCRYPT_SECRET_AGREEMENT_OPERATION       0x00000008
  487. #define BCRYPT_SIGNATURE_OPERATION              0x00000010
  488. #define BCRYPT_RNG_OPERATION                    0x00000020
  490. // USE EXTREME CAUTION: editing comments that contain "certenrolls_*" tokens
  491. // could break building CertEnroll idl files:
  492. // certenrolls_begin -- BCRYPT_ALGORITHM_IDENTIFIER
  493. typedef struct _BCRYPT_ALGORITHM_IDENTIFIER
  494. {
  495.     LPWSTR  pszName;
  496.     ULONG   dwClass;
  497.     ULONG   dwFlags;
  499. } BCRYPT_ALGORITHM_IDENTIFIER;
  500. // certenrolls_end
  502. NTSTATUS
  503. WINAPI
  504. BCryptEnumAlgorithms(
  505.     __in    ULONG   dwAlgOperations,
  506.     __out   ULONG   *pAlgCount,
  507.     __out   BCRYPT_ALGORITHM_IDENTIFIER **ppAlgList,
  508.     __in    ULONG   dwFlags);
  511. typedef struct _BCRYPT_PROVIDER_NAME
  512. {
  513.     LPWSTR  pszProviderName;
  514. } BCRYPT_PROVIDER_NAME;
  516. NTSTATUS
  517. WINAPI
  518. BCryptEnumProviders(
  519.     __in    LPCWSTR pszAlgId,
  520.     __out   ULONG   *pImplCount,
  521.     __out   BCRYPT_PROVIDER_NAME    **ppImplList,
  522.     __in    ULONG   dwFlags);
  525. // Flags for use with BCryptGetProperty and BCryptSetProperty
  526. #define BCRYPT_PUBLIC_KEY_FLAG                  0x00000001
  527. #define BCRYPT_PRIVATE_KEY_FLAG                 0x00000002
  530. NTSTATUS
  531. WINAPI
  532. BCryptGetProperty(
  533.     __in                                        BCRYPT_HANDLE   hObject,
  534.     __in                                        LPCWSTR pszProperty,
  535.     __out_bcount_part_opt(cbOutput, *pcbResult) PUCHAR   pbOutput,
  536.     __in                                        ULONG   cbOutput,
  537.     __out                                       ULONG   *pcbResult,
  538.     __in                                        ULONG   dwFlags);
  540. // @@BEGIN_DDKSPLIT
  541. typedef NTSTATUS
  542. (WINAPI * BCryptGetPropertyFn)(
  543.     __in                                        BCRYPT_HANDLE   hObject,
  544.     __in                                        LPCWSTR pszProperty,
  545.     __out_bcount_part_opt(cbOutput, *pcbResult) PUCHAR   pbOutput,
  546.     __in                                        ULONG   cbOutput,
  547.     __out                                       ULONG   *pcbResult,
  548.     __in                                        ULONG   dwFlags);
  551. // @@END_DDKSPLIT
  554. NTSTATUS
  555. WINAPI
  556. BCryptSetProperty(
  557.     __inout                 BCRYPT_HANDLE   hObject,
  558.     __in                    LPCWSTR pszProperty,
  559.     __in_bcount(cbInput)    PUCHAR   pbInput,
  560.     __in                    ULONG   cbInput,
  561.     __in                    ULONG   dwFlags);
  563. // @@BEGIN_DDKSPLIT
  564. typedef NTSTATUS
  565. (WINAPI * BCryptSetPropertyFn)(
  566.     __inout                 BCRYPT_HANDLE   hObject,
  567.     __in                    LPCWSTR pszProperty,
  568.     __in_bcount(cbInput)    PUCHAR   pbInput,
  569.     __in                    ULONG   cbInput,
  570.     __in                    ULONG   dwFlags);
  572. // @@END_DDKSPLIT
  576. NTSTATUS
  577. WINAPI
  578. BCryptCloseAlgorithmProvider(
  579.     __inout BCRYPT_ALG_HANDLE   hAlgorithm,
  580.     __in    ULONG   dwFlags);
  582. // @@BEGIN_DDKSPLIT
  583. typedef NTSTATUS
  584. (WINAPI * BCryptCloseAlgorithmProviderFn)(
  585.     __inout BCRYPT_ALG_HANDLE   hAlgorithm,
  586.     __in    ULONG   dwFlags);
  588. // @@END_DDKSPLIT
  592. VOID
  593. WINAPI
  594. BCryptFreeBuffer(
  595.     __deref PVOID   pvBuffer);
  597. // @@BEGIN_DDKSPLIT
  598. typedef VOID
  599. (WINAPI * BCryptFreeBufferFn)(
  600.     __deref PVOID   pvBuffer);
  602. // @@END_DDKSPLIT
  606. //
  607. // Primitive encryption functions.
  608. //
  610. NTSTATUS
  611. WINAPI
  612. BCryptGenerateSymmetricKey(
  613.     __inout                         BCRYPT_ALG_HANDLE   hAlgorithm,
  614.     __out                           BCRYPT_KEY_HANDLE   *phKey,
  615.     __out_bcount_full(cbKeyObject)  PUCHAR   pbKeyObject,
  616.     __in                            ULONG   cbKeyObject,
  617.     __in_bcount(cbSecret)           PUCHAR   pbSecret,
  618.     __in                            ULONG   cbSecret,
  619.     __in                            ULONG   dwFlags);
  621. // @@BEGIN_DDKSPLIT
  622. typedef NTSTATUS
  623. (WINAPI * BCryptGenerateSymmetricKeyFn)(
  624.     __inout                         BCRYPT_ALG_HANDLE   hAlgorithm,
  625.     __out                           BCRYPT_KEY_HANDLE   *phKey,
  626.     __out_bcount_full(cbKeyObject)  PUCHAR   pbKeyObject,
  627.     __in                            ULONG   cbKeyObject,
  628.     __in_bcount(cbSecret)           PUCHAR   pbSecret,
  629.     __in                            ULONG   cbSecret,
  630.     __in                            ULONG   dwFlags);
  632. // @@END_DDKSPLIT
  636. NTSTATUS
  637. WINAPI
  638. BCryptGenerateKeyPair(
  639.     __inout BCRYPT_ALG_HANDLE   hAlgorithm,
  640.     __out   BCRYPT_KEY_HANDLE   *phKey,
  641.     __in    ULONG   dwLength,
  642.     __in    ULONG   dwFlags);
  644. // @@BEGIN_DDKSPLIT
  645. typedef NTSTATUS
  646. (WINAPI * BCryptGenerateKeyPairFn)(
  647.     __inout BCRYPT_ALG_HANDLE   hAlgorithm,
  648.     __out   BCRYPT_KEY_HANDLE   *phKey,
  649.     __in    ULONG   dwLength,
  650.     __in    ULONG   dwFlags);
  652. // @@END_DDKSPLIT
  656. NTSTATUS
  657. WINAPI
  658. BCryptEncrypt(
  659.     __inout                                     BCRYPT_KEY_HANDLE hKey,
  660.     __in_bcount(cbInput)                        PUCHAR   pbInput,
  661.     __in                                        ULONG   cbInput,
  662.     __in_opt                                    VOID    *pPaddingInfo,
  663.     __inout_bcount_opt(cbIV)                    PUCHAR   pbIV,
  664.     __in                                        ULONG   cbIV,
  665.     __out_bcount_part_opt(cbOutput, *pcbResult) PUCHAR   pbOutput,
  666.     __in                                        ULONG   cbOutput,
  667.     __out                                       ULONG   *pcbResult,
  668.     __in                                        ULONG   dwFlags);
  670. // @@BEGIN_DDKSPLIT
  671. typedef NTSTATUS
  672. (WINAPI * BCryptEncryptFn)(
  673.     __inout                                     BCRYPT_KEY_HANDLE   hKey,
  674.     __in_bcount(cbInput)                        PUCHAR   pbInput,
  675.     __in                                        ULONG   cbInput,
  676.     __in_opt                                    VOID    *pPaddingInfo,
  677.     __inout_bcount_opt(cbIV)                    PUCHAR   pbIV,
  678.     __in                                        ULONG   cbIV,
  679.     __out_bcount_part_opt(cbOutput, *pcbResult) PUCHAR   pbOutput,
  680.     __in                                        ULONG   cbOutput,
  681.     __out                                       ULONG   *pcbResult,
  682.     __in                                        ULONG   dwFlags);
  684. // @@END_DDKSPLIT
  688. NTSTATUS
  689. WINAPI
  690. BCryptDecrypt(
  691.     __inout                                     BCRYPT_KEY_HANDLE   hKey,
  692.     __in_bcount(cbInput)                        PUCHAR   pbInput,
  693.     __in                                        ULONG   cbInput,
  694.     __in_opt                                    VOID    *pPaddingInfo,
  695.     __inout_bcount_opt(cbIV)                    PUCHAR   pbIV,
  696.     __in                                        ULONG   cbIV,
  697.     __out_bcount_part_opt(cbOutput, *pcbResult) PUCHAR   pbOutput,
  698.     __in                                        ULONG   cbOutput,
  699.     __out                                       ULONG   *pcbResult,
  700.     __in                                        ULONG   dwFlags);
  702. // @@BEGIN_DDKSPLIT
  703. typedef NTSTATUS
  704. (WINAPI * BCryptDecryptFn)(
  705.     __inout                                     BCRYPT_KEY_HANDLE   hKey,
  706.     __in_bcount(cbInput)                        PUCHAR   pbInput,
  707.     __in                                        ULONG   cbInput,
  708.     __in_opt                                    VOID    *pPaddingInfo,
  709.     __inout_bcount_opt(cbIV)                    PUCHAR   pbIV,
  710.     __in                                        ULONG   cbIV,
  711.     __out_bcount_part_opt(cbOutput, *pcbResult) PUCHAR   pbOutput,
  712.     __in                                        ULONG   cbOutput,
  713.     __out                                       ULONG   *pcbResult,
  714.     __in                                        ULONG   dwFlags);
  716. // @@END_DDKSPLIT
  720. NTSTATUS
  721. WINAPI
  722. BCryptExportKey(
  723.     __in                                        BCRYPT_KEY_HANDLE   hKey,
  724.     __in_opt                                    BCRYPT_KEY_HANDLE   hExportKey,
  725.     __in                                        LPCWSTR pszBlobType,
  726.     __out_bcount_part_opt(cbOutput, *pcbResult) PUCHAR   pbOutput,
  727.     __in                                        ULONG   cbOutput,
  728.     __out                                       ULONG   *pcbResult,
  729.     __in                                        ULONG   dwFlags);
  731. // @@BEGIN_DDKSPLIT
  732. typedef NTSTATUS
  733. (WINAPI * BCryptExportKeyFn)(
  734.     __in                                        BCRYPT_KEY_HANDLE   hKey,
  735.     __in_opt                                    BCRYPT_KEY_HANDLE   hExportKey,
  736.     __in                                        LPCWSTR pszBlobType,
  737.     __out_bcount_part_opt(cbOutput, *pcbResult) PUCHAR   pbOutput,
  738.     __in                                        ULONG   cbOutput,
  739.     __out                                       ULONG   *pcbResult,
  740.     __in                                        ULONG   dwFlags);
  742. // @@END_DDKSPLIT
  746. NTSTATUS
  747. WINAPI
  748. BCryptImportKey(
  749.     __in                            BCRYPT_ALG_HANDLE hAlgorithm,
  750.     __in_opt                        BCRYPT_KEY_HANDLE hImportKey,
  751.     __in                            LPCWSTR pszBlobType,
  752.     __out                           BCRYPT_KEY_HANDLE *phKey,
  753.     __out_bcount_full(cbKeyObject)  PUCHAR   pbKeyObject,
  754.     __in                            ULONG   cbKeyObject,
  755.     __in_bcount(cbInput)            PUCHAR   pbInput,
  756.     __in                            ULONG   cbInput,
  757.     __in                            ULONG   dwFlags);
  759. // @@BEGIN_DDKSPLIT
  760. typedef NTSTATUS
  761. (WINAPI * BCryptImportKeyFn)(
  762.     __in                            BCRYPT_ALG_HANDLE hAlgorithm,
  763.     __in_opt                        BCRYPT_KEY_HANDLE hImportKey,
  764.     __in                            LPCWSTR pszBlobType,
  765.     __out                           BCRYPT_KEY_HANDLE *phKey,
  766.     __out_bcount_full(cbKeyObject)  PUCHAR   pbKeyObject,
  767.     __in                            ULONG   cbKeyObject,
  768.     __in_bcount(cbInput)            PUCHAR   pbInput,
  769.     __in                            ULONG   cbInput,
  770.     __in                            ULONG   dwFlags);
  772. // @@END_DDKSPLIT
  776. #define BCRYPT_NO_KEY_VALIDATION    0x00000008
  778. NTSTATUS
  779. WINAPI
  780. BCryptImportKeyPair(
  781.     __in                            BCRYPT_ALG_HANDLE hAlgorithm,
  782.     __in_opt                        BCRYPT_KEY_HANDLE hImportKey,
  783.     __in                            LPCWSTR pszBlobType,
  784.     __out                           BCRYPT_KEY_HANDLE *phKey,
  785.     __in_bcount(cbInput)            PUCHAR   pbInput,
  786.     __in                            ULONG   cbInput,
  787.     __in                            ULONG   dwFlags);
  789. // @@BEGIN_DDKSPLIT
  790. typedef NTSTATUS
  791. (WINAPI * BCryptImportKeyPairFn)(
  792.     __in                            BCRYPT_ALG_HANDLE hAlgorithm,
  793.     __in_opt                        BCRYPT_KEY_HANDLE hImportKey,
  794.     __in                            LPCWSTR pszBlobType,
  795.     __out                           BCRYPT_KEY_HANDLE *phKey,
  796.     __in_bcount(cbInput)            PUCHAR   pbInput,
  797.     __in                            ULONG   cbInput,
  798.     __in                            ULONG   dwFlags);
  800. // @@END_DDKSPLIT
  804. NTSTATUS
  805. WINAPI
  806. BCryptDuplicateKey(
  807.     __in                            BCRYPT_KEY_HANDLE   hKey,
  808.     __out                           BCRYPT_KEY_HANDLE   *phNewKey,
  809.     __out_bcount_full(cbKeyObject)  PUCHAR   pbKeyObject,
  810.     __in                            ULONG   cbKeyObject,
  811.     __in                            ULONG   dwFlags);
  813. // @@BEGIN_DDKSPLIT
  814. typedef NTSTATUS
  815. (WINAPI * BCryptDuplicateKeyFn)(
  816.     __in                            BCRYPT_KEY_HANDLE   hKey,
  817.     __out                           BCRYPT_KEY_HANDLE   *phNewKey,
  818.     __out_bcount_full(cbKeyObject)  PUCHAR   pbKeyObject,
  819.     __in                            ULONG   cbKeyObject,
  820.     __in                            ULONG   dwFlags);
  822. // @@END_DDKSPLIT
  826. NTSTATUS
  827. WINAPI
  828. BCryptFinalizeKeyPair(
  829.     __inout BCRYPT_KEY_HANDLE   hKey,
  830.     __in    ULONG   dwFlags);
  832. // @@BEGIN_DDKSPLIT
  833. typedef NTSTATUS
  834. (WINAPI * BCryptFinalizeKeyPairFn)(
  835.     __inout BCRYPT_KEY_HANDLE   hKey,
  836.     __in    ULONG   dwFlags);
  838. // @@END_DDKSPLIT
  842. NTSTATUS
  843. WINAPI
  844. BCryptDestroyKey(
  845.     __inout BCRYPT_KEY_HANDLE   hKey);
  847. // @@BEGIN_DDKSPLIT
  848. typedef NTSTATUS
  849. (WINAPI * BCryptDestroyKeyFn)(
  850.     __inout BCRYPT_KEY_HANDLE hKey);
  852. // @@END_DDKSPLIT
  855. NTSTATUS
  856. WINAPI
  857. BCryptDestroySecret(
  858.     __inout BCRYPT_SECRET_HANDLE   hSecret);
  860. // @@BEGIN_DDKSPLIT
  861. typedef NTSTATUS
  862. (WINAPI * BCryptDestroySecretFn)(
  863.     __inout BCRYPT_SECRET_HANDLE hSecret);
  865. // @@END_DDKSPLIT
  869. NTSTATUS
  870. WINAPI
  871. BCryptSignHash(
  872.     __in                                        BCRYPT_KEY_HANDLE   hKey,
  873.     __in_opt                                    VOID    *pPaddingInfo,
  874.     __in_bcount(cbInput)                        PUCHAR   pbInput,
  875.     __in                                        ULONG   cbInput,
  876.     __out_bcount_part_opt(cbOutput, *pcbResult) PUCHAR   pbOutput,
  877.     __in                                        ULONG   cbOutput,
  878.     __out                                       ULONG   *pcbResult,
  879.     __in                                        ULONG   dwFlags);
  881. // @@BEGIN_DDKSPLIT
  882. typedef NTSTATUS
  883. (WINAPI * BCryptSignHashFn)(
  884.     __in                                        BCRYPT_KEY_HANDLE   hKey,
  885.     __in_opt                                    VOID    *pPaddingInfo,
  886.     __in_bcount(cbInput)                        PUCHAR   pbInput,
  887.     __in                                        ULONG   cbInput,
  888.     __out_bcount_part_opt(cbOutput, *pcbResult) PUCHAR   pbOutput,
  889.     __in                                        ULONG   cbOutput,
  890.     __out                                       ULONG   *pcbResult,
  891.     __in                                        ULONG   dwFlags);
  893. // @@END_DDKSPLIT
  897. NTSTATUS
  898. WINAPI
  899. BCryptVerifySignature(
  900.     __in                        BCRYPT_KEY_HANDLE   hKey,
  901.     __in_opt                    VOID    *pPaddingInfo,
  902.     __in_bcount(cbHash)         PUCHAR   pbHash,
  903.     __in                        ULONG   cbHash,
  904.     __in_bcount(cbSignature)    PUCHAR   pbSignature,
  905.     __in                        ULONG   cbSignature,
  906.     __in                        ULONG   dwFlags);
  908. // @@BEGIN_DDKSPLIT
  909. typedef NTSTATUS
  910. (WINAPI * BCryptVerifySignatureFn)(
  911.     __in                        BCRYPT_KEY_HANDLE   hKey,
  912.     __in_opt                    VOID    *pPaddingInfo,
  913.     __in_bcount(cbHash)         PUCHAR   pbHash,
  914.     __in                        ULONG   cbHash,
  915.     __in_bcount(cbSignature)    PUCHAR   pbSignature,
  916.     __in                        ULONG   cbSignature,
  917.     __in                        ULONG   dwFlags);
  919. // @@END_DDKSPLIT
  923. NTSTATUS
  924. WINAPI
  925. BCryptSecretAgreement(
  926.     __in    BCRYPT_KEY_HANDLE       hPrivKey,
  927.     __in    BCRYPT_KEY_HANDLE       hPubKey,
  928.     __out   BCRYPT_SECRET_HANDLE    *phAgreedSecret,
  929.     __in    ULONG                   dwFlags);
  931. // @@BEGIN_DDKSPLIT
  932. typedef NTSTATUS
  933. (WINAPI * BCryptSecretAgreementFn)(
  934.     __in    BCRYPT_KEY_HANDLE       hPrivKey,
  935.     __in    BCRYPT_KEY_HANDLE       hPubKey,
  936.     __out   BCRYPT_SECRET_HANDLE    *phAgreedSecret,
  937.     __in    ULONG                   dwFlags);
  939. // @@END_DDKSPLIT
  942. NTSTATUS
  943. WINAPI
  944. BCryptDeriveKey(
  945.     __in        BCRYPT_SECRET_HANDLE hSharedSecret,
  946.     __in        LPCWSTR              pwszKDF,
  947.     __in_opt    BCryptBufferDesc     *pParameterList,
  948.     __out_bcount_part_opt(cbDerivedKey, *pcbResult) PUCHAR pbDerivedKey,
  949.     __in        ULONG                cbDerivedKey,
  950.     __out       ULONG                *pcbResult,
  951.     __in        ULONG                dwFlags);
  953. // @@BEGIN_DDKSPLIT
  954. typedef NTSTATUS
  955. (WINAPI * BCryptDeriveKeyFn)(
  956.     __in        BCRYPT_SECRET_HANDLE hSharedSecret,
  957.     __in        LPCWSTR              pwszKDF,
  958.     __in_opt    BCryptBufferDesc     *pParameterList,
  959.     __out_bcount_part_opt(cbDerivedKey, *pcbResult) PUCHAR pbDerivedKey,
  960.     __in        ULONG                cbDerivedKey,
  961.     __out       ULONG                *pcbResult,
  962.     __in        ULONG                dwFlags);
  964. // @@END_DDKSPLIT
  967. //
  968. // Primitive hashing functions.
  969. //
  971. NTSTATUS
  972. WINAPI
  973. BCryptCreateHash(
  974.     __inout                         BCRYPT_ALG_HANDLE   hAlgorithm,
  975.     __out                           BCRYPT_HASH_HANDLE  *phHash,
  976.     __out_bcount_full(cbHashObject) PUCHAR   pbHashObject,
  977.     __in                            ULONG   cbHashObject,
  978.     __in_bcount_opt(cbSecret)       PUCHAR   pbSecret,   // optional
  979.     __in                            ULONG   cbSecret,   // optional
  980.     __in                            ULONG   dwFlags);
  982. // @@BEGIN_DDKSPLIT
  983. typedef NTSTATUS
  984. (WINAPI * BCryptCreateHashFn)(
  985.     __inout                          BCRYPT_ALG_HANDLE   hAlgorithm,
  986.     __out                           BCRYPT_HASH_HANDLE  *phHash,
  987.     __out_bcount_full(cbHashObject) PUCHAR   pbHashObject,
  988.     __in                            ULONG   cbHashObject,
  989.     __in_bcount_opt(cbSecret)       PUCHAR   pbSecret,   // optional
  990.     __in                            ULONG   cbSecret,   // optional
  991.     __in                            ULONG   dwFlags);
  993. // @@END_DDKSPLIT
  997. NTSTATUS
  998. WINAPI
  999. BCryptHashData(
  1000.     __inout                 BCRYPT_HASH_HANDLE  hHash,
  1001.     __in_bcount(cbInput)    PUCHAR   pbInput,
  1002.     __in                    ULONG   cbInput,
  1003.     __in                    ULONG   dwFlags);
  1005. // @@BEGIN_DDKSPLIT
  1006. typedef NTSTATUS
  1007. (WINAPI * BCryptHashDataFn)(
  1008.     __inout                 BCRYPT_HASH_HANDLE hHash,
  1009.     __in_bcount(cbInput)    PUCHAR   pbInput,
  1010.     __in                    ULONG   cbInput,
  1011.     __in                    ULONG   dwFlags);
  1013. // @@END_DDKSPLIT
  1017. NTSTATUS
  1018. WINAPI
  1019. BCryptFinishHash(
  1020.     __inout                     BCRYPT_HASH_HANDLE hHash,
  1021.     __out_bcount_full(cbOutput) PUCHAR   pbOutput,
  1022.     __in                        ULONG   cbOutput,
  1023.     __in                        ULONG   dwFlags);
  1025. // @@BEGIN_DDKSPLIT
  1026. typedef NTSTATUS
  1027. (WINAPI * BCryptFinishHashFn)(
  1028.     __inout                     BCRYPT_HASH_HANDLE  hHash,
  1029.     __out_bcount_full(cbOutput) PUCHAR   pbOutput,
  1030.     __in                        ULONG   cbOutput,
  1031.     __in                        ULONG   dwFlags);
  1033. // @@END_DDKSPLIT
  1037. NTSTATUS
  1038. WINAPI
  1039. BCryptDuplicateHash(
  1040.     __in                            BCRYPT_HASH_HANDLE  hHash,
  1041.     __out                           BCRYPT_HASH_HANDLE  *phNewHash,
  1042.     __out_bcount_full(cbHashObject) PUCHAR   pbHashObject,
  1043.     __in                            ULONG   cbHashObject,
  1044.     __in                            ULONG   dwFlags);
  1046. // @@BEGIN_DDKSPLIT
  1047. typedef NTSTATUS
  1048. (WINAPI * BCryptDuplicateHashFn)(
  1049.     __in                            BCRYPT_HASH_HANDLE hHash,
  1050.     __out                           BCRYPT_HASH_HANDLE * phNewHash,
  1051.     __out_bcount_full(cbHashObject) PUCHAR pbHashObject,
  1052.     __in                            ULONG   cbHashObject,
  1053.     __in                            ULONG   dwFlags);
  1055. // @@END_DDKSPLIT
  1059. NTSTATUS
  1060. WINAPI
  1061. BCryptDestroyHash(
  1062.     __inout BCRYPT_HASH_HANDLE  hHash);
  1064. // @@BEGIN_DDKSPLIT
  1065. typedef NTSTATUS
  1066. (WINAPI * BCryptDestroyHashFn)(
  1067.     __inout BCRYPT_HASH_HANDLE  hHash);
  1069. // @@END_DDKSPLIT
  1073. //
  1074. // Primitive random number generation.
  1075. //
  1077. // Flags to BCryptGenRandom
  1078. #define BCRYPT_RNG_USE_ENTROPY_IN_BUFFER    0x00000001
  1079. #define BCRYPT_USE_SYSTEM_PREFERRED_RNG     0x00000002
  1081. NTSTATUS
  1082. WINAPI
  1083. BCryptGenRandom(
  1084.     __inout                         BCRYPT_ALG_HANDLE   hAlgorithm,
  1085.     __inout_bcount_full(cbBuffer)   PUCHAR  pbBuffer,
  1086.     __in                            ULONG   cbBuffer,
  1087.     __in                            ULONG   dwFlags);
  1089. // @@BEGIN_DDKSPLIT
  1090. typedef NTSTATUS
  1091. (WINAPI * BCryptGenRandomFn)(
  1092.     __inout                         BCRYPT_ALG_HANDLE   hAlgorithm,
  1093.     __inout_bcount_full(cbBuffer)   PUCHAR   pbBuffer,
  1094.     __in                            ULONG   cbBuffer,
  1095.     __in                            ULONG   dwFlags);
  1097. // @@END_DDKSPLIT
  1101. //
  1102. // Interface version control...
  1103. //
  1104. typedef struct _BCRYPT_INTERFACE_VERSION
  1105. {
  1106.     USHORT MajorVersion;
  1107.     USHORT MinorVersion;
  1109. } BCRYPT_INTERFACE_VERSION, *PBCRYPT_INTERFACE_VERSION;
  1111. #define BCRYPT_MAKE_INTERFACE_VERSION(major,minor) {(USHORT)major, (USHORT)minor}
  1113. #define BCRYPT_IS_INTERFACE_VERSION_COMPATIBLE(loader, provider)    
  1114.     ((loader).MajorVersion <= (provider).MajorVersion)
  1116. //
  1117. // Primitive provider interfaces.
  1118. //
  1120. #define BCRYPT_CIPHER_INTERFACE_VERSION_1    BCRYPT_MAKE_INTERFACE_VERSION(1,0)
  1122. // @@BEGIN_DDKSPLIT
  1123. typedef struct _BCRYPT_CIPHER_FUNCTION_TABLE
  1124. {
  1125.     BCRYPT_INTERFACE_VERSION        Version;
  1126.     BCryptOpenAlgorithmProviderFn   OpenAlgorithmProvider;
  1127.     BCryptGetPropertyFn             GetProperty;
  1128.     BCryptSetPropertyFn             SetProperty;
  1129.     BCryptCloseAlgorithmProviderFn  CloseAlgorithmProvider;
  1130.     BCryptGenerateSymmetricKeyFn    GenerateKey;
  1131.     BCryptEncryptFn                 Encrypt;
  1132.     BCryptDecryptFn                 Decrypt;
  1133.     BCryptImportKeyFn               ImportKey;
  1134.     BCryptExportKeyFn               ExportKey;
  1135.     BCryptDuplicateKeyFn            DuplicateKey;
  1136.     BCryptDestroyKeyFn              DestroyKey;
  1137. } BCRYPT_CIPHER_FUNCTION_TABLE;
  1139. NTSTATUS
  1140. WINAPI
  1141. GetCipherInterface(
  1142.     __in    LPCWSTR pszProviderName,
  1143.     __in    LPCWSTR pszAlgId,
  1144.     __out   BCRYPT_CIPHER_FUNCTION_TABLE **ppFunctionTable,
  1145.     __in    ULONG dwFlags);
  1147. typedef NTSTATUS
  1148. (WINAPI * GetCipherInterfaceFn)(
  1149.     __in    LPCWSTR pszProviderName,
  1150.     __in    LPCWSTR pszAlgId,
  1151.     __out   BCRYPT_CIPHER_FUNCTION_TABLE **ppFunctionTable,
  1152.     __in    ULONG dwFlags);
  1154. // @@END_DDKSPLIT
  1156. #define BCRYPT_HASH_INTERFACE_VERSION_1    BCRYPT_MAKE_INTERFACE_VERSION(1,0)
  1158. // @@BEGIN_DDKSPLIT
  1159. typedef struct _BCRYPT_HASH_FUNCTION_TABLE
  1160. {
  1161.     BCRYPT_INTERFACE_VERSION        Version;
  1162.     BCryptOpenAlgorithmProviderFn   OpenAlgorithmProvider;
  1163.     BCryptGetPropertyFn             GetProperty;
  1164.     BCryptSetPropertyFn             SetProperty;
  1165.     BCryptCloseAlgorithmProviderFn  CloseAlgorithmProvider;
  1166.     BCryptCreateHashFn              CreateHash;
  1167.     BCryptHashDataFn                HashData;
  1168.     BCryptFinishHashFn              FinishHash;
  1169.     BCryptDuplicateHashFn           DuplicateHash;
  1170.     BCryptDestroyHashFn             DestroyHash;
  1171. } BCRYPT_HASH_FUNCTION_TABLE;
  1173. NTSTATUS
  1174. WINAPI
  1175. GetHashInterface(
  1176.     __in    LPCWSTR pszProviderName,
  1177.     __in    LPCWSTR pszAlgId,
  1178.     __out   BCRYPT_HASH_FUNCTION_TABLE **ppFunctionTable,
  1179.     __in    ULONG   dwFlags);
  1181. typedef NTSTATUS
  1182. (WINAPI * GetHashInterfaceFn)(
  1183.     __in    LPCWSTR pszProviderName,
  1184.     __in    LPCWSTR pszAlgId,
  1185.     __out   BCRYPT_HASH_FUNCTION_TABLE **ppFunctionTable,
  1186.     __in    ULONG dwFlags);
  1187. // @@END_DDKSPLIT
  1189. #define BCRYPT_ASYMMETRIC_ENCRYPTION_INTERFACE_VERSION_1    BCRYPT_MAKE_INTERFACE_VERSION(1,0)
  1191. // @@BEGIN_DDKSPLIT
  1192. typedef struct _BCRYPT_ASYMMETRIC_ENCRYPTION_FUNCTION_TABLE
  1193. {
  1194.     BCRYPT_INTERFACE_VERSION        Version;
  1195.     BCryptOpenAlgorithmProviderFn   OpenAlgorithmProvider;
  1196.     BCryptGetPropertyFn             GetProperty;
  1197.     BCryptSetPropertyFn             SetProperty;
  1198.     BCryptCloseAlgorithmProviderFn  CloseAlgorithmProvider;
  1199.     BCryptGenerateKeyPairFn         GenerateKeyPair;
  1200.     BCryptFinalizeKeyPairFn         FinalizeKeyPair;
  1201.     BCryptEncryptFn                 Encrypt;
  1202.     BCryptDecryptFn                 Decrypt;
  1203.     BCryptImportKeyPairFn           ImportKeyPair;
  1204.     BCryptExportKeyFn               ExportKey;
  1205.     BCryptDestroyKeyFn              DestroyKey;
  1206.     BCryptSignHashFn                SignHash;
  1207.     BCryptVerifySignatureFn         VerifySignature;
  1208. } BCRYPT_ASYMMETRIC_ENCRYPTION_FUNCTION_TABLE;
  1210. NTSTATUS
  1211. WINAPI
  1212. GetAsymmetricEncryptionInterface(
  1213.     __in    LPCWSTR pszProviderName,
  1214.     __in    LPCWSTR pszAlgId,
  1215.     __out   BCRYPT_ASYMMETRIC_ENCRYPTION_FUNCTION_TABLE **ppFunctionTable,
  1216.     __in    ULONG   dwFlags);
  1218. typedef NTSTATUS
  1219. (WINAPI * GetAsymmetricEncryptionInterfaceFn)(
  1220.     __in    LPCWSTR pszProviderName,
  1221.     __in    LPCWSTR pszAlgId,
  1222.     __out   BCRYPT_ASYMMETRIC_ENCRYPTION_FUNCTION_TABLE **ppFunctionTable,
  1223.     __in    ULONG dwFlags);
  1225. // @@END_DDKSPLIT
  1227. #define BCRYPT_SECRET_AGREEMENT_INTERFACE_VERSION_1    BCRYPT_MAKE_INTERFACE_VERSION(1,0)
  1229. // @@BEGIN_DDKSPLIT
  1230. typedef struct _BCRYPT_SECRET_AGREEMENT_FUNCTION_TABLE
  1231. {
  1232.     BCRYPT_INTERFACE_VERSION        Version;
  1233.     BCryptOpenAlgorithmProviderFn   OpenAlgorithmProvider;
  1234.     BCryptGetPropertyFn             GetProperty;
  1235.     BCryptSetPropertyFn             SetProperty;
  1236.     BCryptCloseAlgorithmProviderFn  CloseAlgorithmProvider;
  1237.     BCryptSecretAgreementFn         SecretAgreement;
  1238.     BCryptDeriveKeyFn               DeriveKey;
  1239.     BCryptDestroySecretFn           DestroySecret;
  1240.     BCryptGenerateKeyPairFn         GenerateKeyPair;
  1241.     BCryptFinalizeKeyPairFn         FinalizeKeyPair;
  1242.     BCryptImportKeyPairFn           ImportKeyPair;
  1243.     BCryptExportKeyFn               ExportKey;
  1244.     BCryptDestroyKeyFn              DestroyKey;
  1245. } BCRYPT_SECRET_AGREEMENT_FUNCTION_TABLE;
  1247. NTSTATUS
  1248. WINAPI
  1249. GetSecretAgreementInterface(
  1250.     __in    LPCWSTR pszProviderName,
  1251.     __in    LPCWSTR pszAlgId,
  1252.     __out   BCRYPT_SECRET_AGREEMENT_FUNCTION_TABLE **ppFunctionTable,
  1253.     __in    ULONG   dwFlags);
  1255. typedef NTSTATUS
  1256. (WINAPI * GetSecretAgreementInterfaceFn)(
  1257.     __in    LPCWSTR pszProviderName,
  1258.     __in    LPCWSTR pszAlgId,
  1259.     __out   BCRYPT_SECRET_AGREEMENT_FUNCTION_TABLE **ppFunctionTable,
  1260.     __in    ULONG dwFlags);
  1262. // @@END_DDKSPLIT
  1264. #define BCRYPT_SIGNATURE_INTERFACE_VERSION_1    BCRYPT_MAKE_INTERFACE_VERSION(1,0)
  1266. // @@BEGIN_DDKSPLIT
  1267. typedef struct _BCRYPT_SIGNATURE_FUNCTION_TABLE
  1268. {
  1269.     BCRYPT_INTERFACE_VERSION        Version;
  1270.     BCryptOpenAlgorithmProviderFn   OpenAlgorithmProvider;
  1271.     BCryptGetPropertyFn             GetProperty;
  1272.     BCryptSetPropertyFn             SetProperty;
  1273.     BCryptCloseAlgorithmProviderFn  CloseAlgorithmProvider;
  1274.     BCryptGenerateKeyPairFn         GenerateKeyPair;
  1275.     BCryptFinalizeKeyPairFn         FinalizeKeyPair;
  1276.     BCryptSignHashFn                SignHash;
  1277.     BCryptVerifySignatureFn         VerifySignature;
  1278.     BCryptImportKeyPairFn           ImportKeyPair;
  1279.     BCryptExportKeyFn               ExportKey;
  1280.     BCryptDestroyKeyFn              DestroyKey;
  1281. } BCRYPT_SIGNATURE_FUNCTION_TABLE;
  1283. NTSTATUS
  1284. WINAPI
  1285. GetSignatureInterface(
  1286.     __in    LPCWSTR pszProviderName,
  1287.     __in    LPCWSTR pszAlgId,
  1288.     __out   BCRYPT_SIGNATURE_FUNCTION_TABLE **ppFunctionTable,
  1289.     __in    ULONG   dwFlags);
  1291. typedef NTSTATUS
  1292. (WINAPI * GetSignatureInterfaceFn)(
  1293.     __in    LPCWSTR pszProviderName,
  1294.     __in    LPCWSTR pszAlgId,
  1295.     __out   BCRYPT_SIGNATURE_FUNCTION_TABLE **ppFunctionTable,
  1296.     __in    ULONG dwFlags);
  1297. // @@END_DDKSPLIT
  1299. #define BCRYPT_RNG_INTERFACE_VERSION_1    BCRYPT_MAKE_INTERFACE_VERSION(1,0)
  1301. // @@BEGIN_DDKSPLIT
  1302. typedef struct _BCRYPT_RNG_FUNCTION_TABLE
  1303. {
  1304.     BCRYPT_INTERFACE_VERSION        Version;
  1305.     BCryptOpenAlgorithmProviderFn   OpenAlgorithmProvider;
  1306.     BCryptGetPropertyFn             GetProperty;
  1307.     BCryptSetPropertyFn             SetProperty;
  1308.     BCryptCloseAlgorithmProviderFn  CloseAlgorithmProvider;
  1309.     BCryptGenRandomFn               GenRandom;
  1310. } BCRYPT_RNG_FUNCTION_TABLE;
  1312. NTSTATUS
  1313. WINAPI
  1314. GetRngInterface(
  1315.     __in    LPCWSTR pszProviderName,
  1316.     __out   BCRYPT_RNG_FUNCTION_TABLE   **ppFunctionTable,
  1317.     __in    ULONG   dwFlags);
  1319. typedef NTSTATUS
  1320. (WINAPI * GetRngInterfaceFn)(
  1321.     __in    LPCWSTR pszProviderName,
  1322.     __out   BCRYPT_RNG_FUNCTION_TABLE **ppFunctionTable,
  1323.     __in    ULONG dwFlags);
  1325. // @@END_DDKSPLIT
  1327. //////////////////////////////////////////////////////////////////////////////
  1328. // CryptoConfig Definitions //////////////////////////////////////////////////
  1329. //////////////////////////////////////////////////////////////////////////////
  1331. // Interface registration flags
  1332. #define CRYPT_MIN_DEPENDENCIES      (0x00000001)
  1333. #define CRYPT_PROCESS_ISOLATE       (0x00010000) // User-mode only
  1335. // Processor modes supported by a provider
  1336. //
  1337. // (Valid for BCryptQueryProviderRegistration and BCryptResolveProviders):
  1338. //
  1339. #define CRYPT_UM                    (0x00000001)    // User mode only
  1340. #define CRYPT_KM                    (0x00000002)    // Kernel mode only
  1341. #define CRYPT_MM                    (0x00000003)    // Multi-mode: Must support BOTH UM and KM
  1342. //
  1343. // (Valid only for BCryptQueryProviderRegistration):
  1344. //
  1345. #define CRYPT_ANY                   (0x00000004)    // Wildcard: Either UM, or KM, or both
  1348. // Write behavior flags
  1349. #define CRYPT_OVERWRITE             (0x00000001)
  1351. // Configuration tables
  1352. #define CRYPT_LOCAL                 (0x00000001)
  1353. #define CRYPT_DOMAIN                (0x00000002)
  1355. // Context configuration flags
  1356. #define CRYPT_EXCLUSIVE             (0x00000001)
  1357. #define CRYPT_OVERRIDE              (0x00010000) // Enterprise table only
  1359. // Resolution and enumeration flags
  1360. #define CRYPT_ALL_FUNCTIONS         (0x00000001)
  1361. #define CRYPT_ALL_PROVIDERS         (0x00000002)
  1363. // Priority list positions
  1364. #define CRYPT_PRIORITY_TOP          (0x00000000)
  1365. #define CRYPT_PRIORITY_BOTTOM       (0xFFFFFFFF)
  1367. // Default system-wide context
  1368. #define CRYPT_DEFAULT_CONTEXT       L"Default"
  1370. //////////////////////////////////////////////////////////////////////////////
  1371. // CryptoConfig Structures ///////////////////////////////////////////////////
  1372. //////////////////////////////////////////////////////////////////////////////
  1374. //
  1375. // Provider Registration Structures
  1376. //
  1378. typedef struct _CRYPT_INTERFACE_REG
  1379. {
  1380.     ULONG dwInterface;
  1381.     ULONG dwFlags;
  1383.     ULONG cFunctions;
  1384.     PWSTR *rgpszFunctions;
  1385. }
  1386. CRYPT_INTERFACE_REG, *PCRYPT_INTERFACE_REG;
  1388. typedef struct _CRYPT_IMAGE_REG
  1389. {
  1390.     PWSTR pszImage;
  1392.     ULONG cInterfaces;
  1393.     PCRYPT_INTERFACE_REG *rgpInterfaces;
  1394. }
  1395. CRYPT_IMAGE_REG, *PCRYPT_IMAGE_REG;
  1397. typedef struct _CRYPT_PROVIDER_REG
  1398. {
  1399.     ULONG cAliases;
  1400.     PWSTR *rgpszAliases;
  1401.     
  1402.     PCRYPT_IMAGE_REG pUM;
  1403.     PCRYPT_IMAGE_REG pKM;
  1404. }
  1405. CRYPT_PROVIDER_REG, *PCRYPT_PROVIDER_REG;
  1407. typedef struct _CRYPT_PROVIDERS
  1408. {
  1409.     ULONG cProviders;
  1410.     PWSTR *rgpszProviders;
  1411. }
  1412. CRYPT_PROVIDERS, *PCRYPT_PROVIDERS;
  1414. //
  1415. // Context Configuration Structures
  1416. //
  1418. typedef struct _CRYPT_CONTEXT_CONFIG
  1419. {
  1420.     ULONG dwFlags;
  1421.     ULONG dwReserved;
  1422. }
  1423. CRYPT_CONTEXT_CONFIG, *PCRYPT_CONTEXT_CONFIG;
  1425. typedef struct _CRYPT_CONTEXT_FUNCTION_CONFIG
  1426. {
  1427.     ULONG dwFlags;
  1428.     ULONG dwReserved;
  1429. }
  1430. CRYPT_CONTEXT_FUNCTION_CONFIG, *PCRYPT_CONTEXT_FUNCTION_CONFIG;
  1432. typedef struct _CRYPT_CONTEXTS
  1433. {
  1434.     ULONG cContexts;
  1435.     PWSTR *rgpszContexts;
  1436. }
  1437. CRYPT_CONTEXTS, *PCRYPT_CONTEXTS;
  1439. typedef struct _CRYPT_CONTEXT_FUNCTIONS
  1440. {
  1441.     ULONG cFunctions;
  1442.     PWSTR *rgpszFunctions;
  1443. }
  1444. CRYPT_CONTEXT_FUNCTIONS, *PCRYPT_CONTEXT_FUNCTIONS;
  1446. typedef struct _CRYPT_CONTEXT_FUNCTION_PROVIDERS
  1447. {
  1448.     ULONG cProviders;
  1449.     PWSTR *rgpszProviders;
  1450. }
  1451. CRYPT_CONTEXT_FUNCTION_PROVIDERS, *PCRYPT_CONTEXT_FUNCTION_PROVIDERS;
  1453. //
  1454. // Provider Resolution Structures
  1455. //
  1457. typedef struct _CRYPT_PROPERTY_REF
  1458. {
  1459.     PWSTR pszProperty;
  1461.     ULONG cbValue;
  1462.     PUCHAR pbValue;
  1463. }
  1464. CRYPT_PROPERTY_REF, *PCRYPT_PROPERTY_REF;
  1466. typedef struct _CRYPT_IMAGE_REF
  1467. {
  1468.     PWSTR pszImage;
  1469.     ULONG dwFlags;
  1470. }
  1471. CRYPT_IMAGE_REF, *PCRYPT_IMAGE_REF;
  1473. typedef struct _CRYPT_PROVIDER_REF
  1474. {
  1475.     ULONG dwInterface;
  1476.     PWSTR pszFunction;
  1477.     PWSTR pszProvider;
  1479.     ULONG cProperties;
  1480.     PCRYPT_PROPERTY_REF *rgpProperties;
  1482.     PCRYPT_IMAGE_REF pUM;
  1483.     PCRYPT_IMAGE_REF pKM;
  1484. }
  1485. CRYPT_PROVIDER_REF, *PCRYPT_PROVIDER_REF;
  1487. typedef struct _CRYPT_PROVIDER_REFS
  1488. {
  1489.     ULONG cProviders;
  1490.     PCRYPT_PROVIDER_REF *rgpProviders;
  1491. }
  1492. CRYPT_PROVIDER_REFS, *PCRYPT_PROVIDER_REFS;
  1494. //////////////////////////////////////////////////////////////////////////////
  1495. // CryptoConfig Functions ////////////////////////////////////////////////////
  1496. //////////////////////////////////////////////////////////////////////////////
  1498. #ifndef KERNEL_MODE_CNG
  1500. // @@BEGIN_DDKSPLIT
  1501. //
  1502. // Provider Registration Functions
  1503. //
  1505. NTSTATUS
  1506. WINAPI
  1507. BCryptRegisterProvider(
  1508.     __in LPCWSTR pszProvider,
  1509.     __in ULONG dwFlags,
  1510.     __in PCRYPT_PROVIDER_REG pReg);
  1512. NTSTATUS
  1513. WINAPI
  1514. BCryptUnregisterProvider(
  1515.     __in LPCWSTR pszProvider);
  1517. // @@END_DDKSPLIT
  1519. NTSTATUS
  1520. WINAPI
  1521. BCryptQueryProviderRegistration(
  1522.     __in LPCWSTR pszProvider,
  1523.     __in ULONG dwMode,
  1524.     __in ULONG dwInterface,
  1525.     __inout ULONG* pcbBuffer,
  1526.     __deref_opt_inout_bcount_part_opt(*pcbBuffer, *pcbBuffer) PCRYPT_PROVIDER_REG *ppBuffer);
  1528. NTSTATUS
  1529. WINAPI
  1530. BCryptEnumRegisteredProviders(
  1531.     __inout ULONG* pcbBuffer,
  1532.     __deref_opt_inout_bcount_part_opt(*pcbBuffer, *pcbBuffer) PCRYPT_PROVIDERS *ppBuffer);
  1534. //
  1535. // Context Configuration Functions
  1536. //
  1538. NTSTATUS
  1539. WINAPI
  1540. BCryptCreateContext(
  1541.     __in ULONG dwTable,
  1542.     __in LPCWSTR pszContext,
  1543.     __in_opt PCRYPT_CONTEXT_CONFIG pConfig); // Optional
  1545. NTSTATUS
  1546. WINAPI
  1547. BCryptDeleteContext(
  1548.     __in ULONG dwTable,
  1549.     __in LPCWSTR pszContext);
  1551. NTSTATUS
  1552. WINAPI
  1553. BCryptEnumContexts(
  1554.     __in ULONG dwTable,
  1555.     __inout ULONG* pcbBuffer,
  1556.     __deref_opt_inout_bcount_part_opt(*pcbBuffer, *pcbBuffer) PCRYPT_CONTEXTS *ppBuffer);
  1558. NTSTATUS
  1559. WINAPI
  1560. BCryptConfigureContext(
  1561.     __in ULONG dwTable,
  1562.     __in LPCWSTR pszContext,
  1563.     __in PCRYPT_CONTEXT_CONFIG pConfig);
  1565. NTSTATUS
  1566. WINAPI
  1567. BCryptQueryContextConfiguration(
  1568.     __in ULONG dwTable,
  1569.     __in LPCWSTR pszContext,
  1570.     __inout ULONG* pcbBuffer,
  1571.     __deref_opt_inout_bcount_part_opt(*pcbBuffer, *pcbBuffer) PCRYPT_CONTEXT_CONFIG *ppBuffer);
  1573. NTSTATUS
  1574. WINAPI
  1575. BCryptAddContextFunction(
  1576.     __in ULONG dwTable,
  1577.     __in LPCWSTR pszContext,
  1578.     __in ULONG dwInterface,
  1579.     __in LPCWSTR pszFunction,
  1580.     __in ULONG dwPosition);
  1582. NTSTATUS
  1583. WINAPI
  1584. BCryptRemoveContextFunction(
  1585.     __in ULONG dwTable,
  1586.     __in LPCWSTR pszContext,
  1587.     __in ULONG dwInterface,
  1588.     __in LPCWSTR pszFunction);
  1590. NTSTATUS
  1591. WINAPI
  1592. BCryptEnumContextFunctions(
  1593.     __in ULONG dwTable,
  1594.     __in LPCWSTR pszContext,
  1595.     __in ULONG dwInterface,
  1596.     __inout ULONG* pcbBuffer,
  1597.     __deref_opt_inout_bcount_part_opt(*pcbBuffer, *pcbBuffer) PCRYPT_CONTEXT_FUNCTIONS *ppBuffer);
  1599. NTSTATUS
  1600. WINAPI
  1601. BCryptConfigureContextFunction(
  1602.     __in ULONG dwTable,
  1603.     __in LPCWSTR pszContext,
  1604.     __in ULONG dwInterface,
  1605.     __in LPCWSTR pszFunction,
  1606.     __in PCRYPT_CONTEXT_FUNCTION_CONFIG pConfig);
  1608. NTSTATUS
  1609. WINAPI
  1610. BCryptQueryContextFunctionConfiguration(
  1611.     __in ULONG dwTable,
  1612.     __in LPCWSTR pszContext,
  1613.     __in ULONG dwInterface,
  1614.     __in LPCWSTR pszFunction,
  1615.     __inout ULONG* pcbBuffer,
  1616.     __deref_opt_inout_bcount_part_opt(*pcbBuffer, *pcbBuffer) PCRYPT_CONTEXT_FUNCTION_CONFIG *ppBuffer);
  1618. // @@BEGIN_DDKSPLIT
  1620. NTSTATUS
  1621. WINAPI
  1622. BCryptAddContextFunctionProvider(
  1623.     __in ULONG dwTable,
  1624.     __in LPCWSTR pszContext,
  1625.     __in ULONG dwInterface,
  1626.     __in LPCWSTR pszFunction,
  1627.     __in LPCWSTR pszProvider,
  1628.     __in ULONG dwPosition);
  1630. NTSTATUS
  1631. WINAPI
  1632. BCryptRemoveContextFunctionProvider(
  1633.     __in ULONG dwTable,
  1634.     __in LPCWSTR pszContext,
  1635.     __in ULONG dwInterface,
  1636.     __in LPCWSTR pszFunction,
  1637.     __in LPCWSTR pszProvider);
  1639. // @@END_DDKSPLIT
  1641. NTSTATUS
  1642. WINAPI
  1643. BCryptEnumContextFunctionProviders(
  1644.     __in ULONG dwTable,
  1645.     __in LPCWSTR pszContext,
  1646.     __in ULONG dwInterface,
  1647.     __in LPCWSTR pszFunction,
  1648.     __inout ULONG* pcbBuffer,
  1649.     __deref_opt_inout_bcount_part_opt(*pcbBuffer, *pcbBuffer) PCRYPT_CONTEXT_FUNCTION_PROVIDERS *ppBuffer);
  1651. NTSTATUS
  1652. WINAPI
  1653. BCryptSetContextFunctionProperty(
  1654.     __in ULONG dwTable,
  1655.     __in LPCWSTR pszContext,
  1656.     __in ULONG dwInterface,
  1657.     __in LPCWSTR pszFunction,
  1658.     __in LPCWSTR pszProperty,
  1659.     __in ULONG cbValue,
  1660.     __in_bcount_opt(cbValue) PUCHAR pbValue);
  1662. NTSTATUS
  1663. WINAPI
  1664. BCryptQueryContextFunctionProperty(
  1665.     __in ULONG dwTable,
  1666.     __in LPCWSTR pszContext,
  1667.     __in ULONG dwInterface,
  1668.     __in LPCWSTR pszFunction,
  1669.     __in LPCWSTR pszProperty,
  1670.     __inout ULONG* pcbValue,
  1671.     __deref_opt_inout_bcount_part_opt(*pcbValue, *pcbValue) PUCHAR *ppbValue);
  1673. #endif //#ifndef KERNEL_MODE_CNG
  1675. //
  1676. // Configuration Change Notification Functions
  1677. //
  1679. #ifdef KERNEL_MODE_CNG
  1680. NTSTATUS
  1681. WINAPI
  1682. BCryptRegisterConfigChangeNotify(
  1683.     __in PRKEVENT pEvent);
  1684. #else
  1685. NTSTATUS
  1686. WINAPI
  1687. BCryptRegisterConfigChangeNotify(
  1688.     __out HANDLE *phEvent);
  1689. #endif
  1691. #ifdef KERNEL_MODE_CNG
  1692. NTSTATUS
  1693. WINAPI
  1694. BCryptUnregisterConfigChangeNotify(
  1695.     __in PRKEVENT pEvent);
  1696. #else
  1697. NTSTATUS
  1698. WINAPI
  1699. BCryptUnregisterConfigChangeNotify(
  1700.     __in HANDLE hEvent);
  1701. #endif
  1703. //
  1704. // Provider Resolution Functions
  1705. //
  1707. NTSTATUS WINAPI
  1708. BCryptResolveProviders(
  1709.     __in_opt LPCWSTR pszContext,
  1710.     __in_opt ULONG dwInterface,
  1711.     __in_opt LPCWSTR pszFunction,
  1712.     __in_opt LPCWSTR pszProvider,
  1713.     __in ULONG dwMode,
  1714.     __in ULONG dwFlags,
  1715.     __inout ULONG* pcbBuffer,
  1716.     __deref_opt_inout_bcount_part_opt(*pcbBuffer, *pcbBuffer) PCRYPT_PROVIDER_REFS *ppBuffer);
  1719. //
  1720. // Miscellaneous queries about the crypto environment
  1721. //
  1723. NTSTATUS
  1724. WINAPI
  1725. BCryptGetFipsAlgorithmMode(
  1726.     __out BOOLEAN *pfEnabled
  1727.     );
  1730. #ifdef __cplusplus
  1731. }
  1732. #endif
  1734. #endif // __BCRYPT_H__