include/bcrypt.h

   1 /*
   2  * Copyright (C) 2007 Francois Gouget
   3  *
   4  * This library is free software; you can redistribute it and/or
   5  * modify it under the terms of the GNU Lesser General Public
   6  * License as published by the Free Software Foundation; either
   7  * version 2.1 of the License, or (at your option) any later version.
   8  *
   9  * This library is distributed in the hope that it will be useful,
  10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  12  * Lesser General Public License for more details.
  13  *
  14  * You should have received a copy of the GNU Lesser General Public
  15  * License along with this library; if not, write to the Free Software
  16  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
  17  */
  18
  19 #ifndef __WINE_BCRYPT_H
  20 #define __WINE_BCRYPT_H
  21
  22 #ifndef WINAPI
  23 #define WINAPI __stdcall
  24 #endif
  25
  26 #ifndef IN
  27 #define IN
  28 #endif
  29
  30 #ifndef OUT
  31 #define OUT
  32 #endif
  33
  34 #ifndef OPTIONAL
  35 #define OPTIONAL
  36 #endif
  37
  38 #ifndef WINE_NTSTATUS_DECLARED
  39 #define WINE_NTSTATUS_DECLARED
  40 typedef LONG NTSTATUS;
  41 #endif
  42
  43 #define BCRYPT_ALGORITHM_NAME (const WCHAR []){'A','l','g','o','r','i','t','h','m','N','a','m','e',0}
  44 #define BCRYPT_AUTH_TAG_LENGTH (const WCHAR []){'A','u','t','h','T','a','g','L','e','n','g','t','h',0}
  45 #define BCRYPT_BLOCK_LENGTH (const WCHAR []){'B','l','o','c','k','L','e','n','g','t','h',0}
  46 #define BCRYPT_BLOCK_SIZE_LIST (const WCHAR []){'B','l','o','c','k','S','i','z','e','L','i','s','t',0}
  47 #define BCRYPT_CHAINING_MODE (const WCHAR []){'C','h','a','i','n','i','n','g','M','o','d','e',0}
  48 #define BCRYPT_EFFECTIVE_KEY_LENGTH (const WCHAR []){'E','f','f','e','c','t','i','v','e','K','e','y','L','e','n','g','t','h',0}
  49 #define BCRYPT_HASH_BLOCK_LENGTH (const WCHAR []){'H','a','s','h','B','l','o','c','k','L','e','n','g','t','h',0}
  50 #define BCRYPT_HASH_LENGTH (const WCHAR []){'H','a','s','h','D','i','g','e','s','t','L','e','n','g','t','h',0}
  51 #define BCRYPT_HASH_OID_LIST (const WCHAR []){'H','a','s','h','O','I','D','L','i','s','t',0}
  52 #define BCRYPT_KEY_LENGTH (const WCHAR []){'K','e','y','L','e','n','g','t','h',0}
  53 #define BCRYPT_KEY_LENGTHS (const WCHAR []){'K','e','y','L','e','n','g','t','h','s',0}
  54 #define BCRYPT_KEY_OBJECT_LENGTH (const WCHAR []){'K','e','y','O','b','j','e','c','t','L','e','n','g','t','h',0}
  55 #define BCRYPT_KEY_STRENGTH (const WCHAR []){'K','e','y','S','t','r','e','n','g','t','h',0}
  56 #define BCRYPT_OBJECT_LENGTH (const WCHAR []){'O','b','j','e','c','t','L','e','n','g','t','h',0}
  57 #define BCRYPT_PADDING_SCHEMES (const WCHAR []){'P','a','d','d','i','n','g','S','c','h','e','m','e','s',0}
  58 #define BCRYPT_PROVIDER_HANDLE (const WCHAR []){'P','r','o','v','i','d','e','r','H','a','n','d','l','e',0}
  59 #define BCRYPT_SIGNATURE_LENGTH (const WCHAR []){'S','i','g','n','a','t','u','r','e','L','e','n','g','t','h',0}
  60
  61 #define BCRYPT_OPAQUE_KEY_BLOB   (const WCHAR []){'O','p','a','q','u','e','K','e','y','B','l','o','b',0}
  62 #define BCRYPT_KEY_DATA_BLOB     (const WCHAR []){'K','e','y','D','a','t','a','B','l','o','b',0}
  63 #define BCRYPT_AES_WRAP_KEY_BLOB (const WCHAR []){'R','f','c','3','5','6','5','K','e','y','W','r','a','p','B','l','o','b',0}
  64 #define BCRYPT_ECCPUBLIC_BLOB    (const WCHAR []){'E','C','C','P','U','B','L','I','C','B','L','O','B',0}
  65 #define BCRYPT_ECCPRIVATE_BLOB   (const WCHAR []){'E','C','C','P','R','I','V','A','T','E','B','L','O','B',0}
  66
  67 #define MS_PRIMITIVE_PROVIDER (const WCHAR [])\
  68     {'M','i','c','r','o','s','o','f','t',' ','P','r','i','m','i','t','i','v','e',' ','P','r','o','v','i','d','e','r',0}
  69 #define MS_PLATFORM_CRYPTO_PROVIDER (const WCHAR [])\
  70     {'M','i','c','r','o','s','o','f','t',' ','P','l','a','t','f','o','r','m',' ','C','r','y','p','t','o',' ','P','r','o','v','i','d','e','r',0}
  71
  72 #define BCRYPT_AES_ALGORITHM        (const WCHAR []){'A','E','S',0}
  73 #define BCRYPT_MD2_ALGORITHM        (const WCHAR []){'M','D','2',0}
  74 #define BCRYPT_MD4_ALGORITHM        (const WCHAR []){'M','D','4',0}
  75 #define BCRYPT_MD5_ALGORITHM        (const WCHAR []){'M','D','5',0}
  76 #define BCRYPT_RNG_ALGORITHM        (const WCHAR []){'R','N','G',0}
  77 #define BCRYPT_SHA1_ALGORITHM       (const WCHAR []){'S','H','A','1',0}
  78 #define BCRYPT_SHA256_ALGORITHM     (const WCHAR []){'S','H','A','2','5','6',0}
  79 #define BCRYPT_SHA384_ALGORITHM     (const WCHAR []){'S','H','A','3','8','4',0}
  80 #define BCRYPT_SHA512_ALGORITHM     (const WCHAR []){'S','H','A','5','1','2',0}
  81 #define BCRYPT_ECDSA_P256_ALGORITHM (const WCHAR []){'E','C','D','S','A','_','P','2','5','6',0}
  82 #define BCRYPT_ECDSA_P384_ALGORITHM (const WCHAR []){'E','C','D','S','A','_','P','3','8','4',0}
  83 #define BCRYPT_ECDSA_P521_ALGORITHM (const WCHAR []){'E','C','D','S','A','_','P','5','2','1',0}
  84
  85 #define BCRYPT_CHAIN_MODE_NA        (const WCHAR []){'C','h','a','i','n','i','n','g','M','o','d','e','N','/','A',0}
  86 #define BCRYPT_CHAIN_MODE_CBC       (const WCHAR []){'C','h','a','i','n','i','n','g','M','o','d','e','C','B','C',0}
  87 #define BCRYPT_CHAIN_MODE_ECB       (const WCHAR []){'C','h','a','i','n','i','n','g','M','o','d','e','E','C','B',0}
  88 #define BCRYPT_CHAIN_MODE_CFB       (const WCHAR []){'C','h','a','i','n','i','n','g','M','o','d','e','C','F','B',0}
  89 #define BCRYPT_CHAIN_MODE_CCM       (const WCHAR []){'C','h','a','i','n','i','n','g','M','o','d','e','C','C','M',0}
  90 #define BCRYPT_CHAIN_MODE_GCM       (const WCHAR []){'C','h','a','i','n','i','n','g','M','o','d','e','G','C','M',0}
  91
  92 #define BCRYPT_ECDSA_PUBLIC_P256_MAGIC  0x31534345
  93 #define BCRYPT_ECDSA_PRIVATE_P256_MAGIC 0x32534345
  94 #define BCRYPT_ECDSA_PUBLIC_P384_MAGIC  0x33534345
  95 #define BCRYPT_ECDSA_PRIVATE_P384_MAGIC 0x34534345
  96 #define BCRYPT_ECDSA_PUBLIC_P521_MAGIC  0x35534345
  97 #define BCRYPT_ECDSA_PRIVATE_P521_MAGIC 0x36534345
  98
  99 typedef struct _BCRYPT_ALGORITHM_IDENTIFIER
 100 {
 101     LPWSTR pszName;
 102     ULONG  dwClass;
 103     ULONG  dwFlags;
 104 } BCRYPT_ALGORITHM_IDENTIFIER;
 105
 106 typedef struct __BCRYPT_KEY_LENGTHS_STRUCT
 107 {
 108     ULONG dwMinLength;
 109     ULONG dwMaxLength;
 110     ULONG dwIncrement;
 111 } BCRYPT_KEY_LENGTHS_STRUCT, BCRYPT_AUTH_TAG_LENGTHS_STRUCT;
 112
 113 typedef struct _BCRYPT_AUTHENTICATED_CIPHER_MODE_INFO
 114 {
 115     ULONG cbSize;
 116     ULONG dwInfoVersion;
 117     UCHAR *pbNonce;
 118     ULONG cbNonce;
 119     UCHAR *pbAuthData;
 120     ULONG cbAuthData;
 121     UCHAR *pbTag;
 122     ULONG cbTag;
 123     UCHAR *pbMacContext;
 124     ULONG cbMacContext;
 125     ULONG cbAAD;
 126     ULONGLONG cbData;
 127     ULONG dwFlags;
 128 } BCRYPT_AUTHENTICATED_CIPHER_MODE_INFO, *PBCRYPT_AUTHENTICATED_CIPHER_MODE_INFO;
 129
 130 typedef struct _BCRYPT_ECCKEY_BLOB
 131 {
 132     ULONG dwMagic;
 133     ULONG cbKey;
 134 } BCRYPT_ECCKEY_BLOB, *PBCRYPT_ECCKEY_BLOB;
 135
 136 typedef struct _BCRYPT_PKCS1_PADDING_INFO
 137 {
 138     LPCWSTR pszAlgId;
 139 } BCRYPT_PKCS1_PADDING_INFO;
 140
 141 #define BCRYPT_PAD_NONE                     0x00000001
 142 #define BCRYPT_PAD_PKCS1                    0x00000002
 143 #define BCRYPT_PAD_OAEP                     0x00000004
 144 #define BCRYPT_PAD_PSS                      0x00000008
 145 #define BCRYPT_PAD_PKCS1_OPTIONAL_HASH_OID  0x00000010
 146
 147 #define BCRYPT_AUTHENTICATED_CIPHER_MODE_INFO_VERSION 1
 148
 149 #define BCRYPT_AUTH_MODE_CHAIN_CALLS_FLAG 0x00000001
 150 #define BCRYPT_AUTH_MODE_IN_PROGRESS_FLAG 0x00000002
 151
 152 typedef struct _CRYPT_INTERFACE_REG
 153 {
 154     ULONG dwInterface;
 155     ULONG dwFlags;
 156     ULONG cFunctions;
 157     PWSTR *rgpszFunctions;
 158 } CRYPT_INTERFACE_REG, *PCRYPT_INTERFACE_REG;
 159
 160 typedef struct _CRYPT_IMAGE_REG
 161 {
 162     PWSTR pszImage;
 163     ULONG cInterfaces;
 164     PCRYPT_INTERFACE_REG *rgpInterfaces;
 165 } CRYPT_IMAGE_REG, *PCRYPT_IMAGE_REG;
 166
 167 typedef struct _CRYPT_PROVIDER_REG
 168 {
 169     ULONG cAliases;
 170     PWSTR *rgpszAliases;
 171     PCRYPT_IMAGE_REG pUM;
 172     PCRYPT_IMAGE_REG pKM;
 173 } CRYPT_PROVIDER_REG, *PCRYPT_PROVIDER_REG;
 174
 175 typedef struct _BCRYPT_KEY_DATA_BLOB_HEADER
 176 {
 177     ULONG dwMagic;
 178     ULONG dwVersion;
 179     ULONG cbKeyData;
 180 } BCRYPT_KEY_DATA_BLOB_HEADER, *PBCRYPT_KEY_DATA_BLOB_HEADER;
 181
 182 #define BCRYPT_KEY_DATA_BLOB_MAGIC    0x4d42444b
 183 #define BCRYPT_KEY_DATA_BLOB_VERSION1 1
 184
 185 typedef PVOID BCRYPT_ALG_HANDLE;
 186 typedef PVOID BCRYPT_KEY_HANDLE;
 187 typedef PVOID BCRYPT_HANDLE;
 188 typedef PVOID BCRYPT_HASH_HANDLE;
 189
 190 /* Flags for BCryptGenRandom */
 191 #define BCRYPT_RNG_USE_ENTROPY_IN_BUFFER 0x00000001
 192 #define BCRYPT_USE_SYSTEM_PREFERRED_RNG  0x00000002
 193
 194 /* Flags for BCryptOpenAlgorithmProvider */
 195 #define BCRYPT_ALG_HANDLE_HMAC_FLAG 0x00000008
 196
 197 /* Flags for BCryptEncrypt/BCryptDecrypt */
 198 #define BCRYPT_BLOCK_PADDING        0x00000001
 199
 200 NTSTATUS WINAPI BCryptCloseAlgorithmProvider(BCRYPT_ALG_HANDLE, ULONG);
 201 NTSTATUS WINAPI BCryptCreateHash(BCRYPT_ALG_HANDLE, BCRYPT_HASH_HANDLE *, PUCHAR, ULONG, PUCHAR, ULONG, ULONG);
 202 NTSTATUS WINAPI BCryptDecrypt(BCRYPT_KEY_HANDLE, PUCHAR, ULONG, VOID *, PUCHAR, ULONG, PUCHAR, ULONG, ULONG *, ULONG);
 203 NTSTATUS WINAPI BCryptDestroyHash(BCRYPT_HASH_HANDLE);
 204 NTSTATUS WINAPI BCryptDestroyKey(BCRYPT_KEY_HANDLE);
 205 NTSTATUS WINAPI BCryptEncrypt(BCRYPT_KEY_HANDLE, PUCHAR, ULONG, VOID *, PUCHAR, ULONG, PUCHAR, ULONG, ULONG *, ULONG);
 206 NTSTATUS WINAPI BCryptEnumAlgorithms(ULONG, ULONG *, BCRYPT_ALGORITHM_IDENTIFIER **, ULONG);
 207 NTSTATUS WINAPI BCryptFinishHash(BCRYPT_HASH_HANDLE, PUCHAR, ULONG, ULONG);
 208 NTSTATUS WINAPI BCryptGenerateSymmetricKey(BCRYPT_ALG_HANDLE, BCRYPT_KEY_HANDLE *, PUCHAR, ULONG, PUCHAR, ULONG, ULONG);
 209 NTSTATUS WINAPI BCryptGenRandom(BCRYPT_ALG_HANDLE, PUCHAR, ULONG, ULONG);
 210 NTSTATUS WINAPI BCryptGetFipsAlgorithmMode(BOOLEAN *);
 211 NTSTATUS WINAPI BCryptGetProperty(BCRYPT_HANDLE, LPCWSTR, PUCHAR, ULONG, ULONG *, ULONG);
 212 NTSTATUS WINAPI BCryptHash(BCRYPT_ALG_HANDLE, PUCHAR, ULONG, PUCHAR, ULONG, PUCHAR, ULONG);
 213 NTSTATUS WINAPI BCryptHashData(BCRYPT_HASH_HANDLE, PUCHAR, ULONG, ULONG);
 214 NTSTATUS WINAPI BCryptOpenAlgorithmProvider(BCRYPT_ALG_HANDLE *, LPCWSTR, LPCWSTR, ULONG);
 215 NTSTATUS WINAPI BCryptSetProperty(BCRYPT_HANDLE, LPCWSTR, PUCHAR, ULONG, ULONG);
 216 NTSTATUS WINAPI BCryptDuplicateHash(BCRYPT_HASH_HANDLE, BCRYPT_HASH_HANDLE *, UCHAR *, ULONG, ULONG);
 217
 218 #endif  /* __WINE_BCRYPT_H */