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 #define BCRYPT_RSAPUBLIC_BLOB    (const WCHAR []){'R','S','A','P','U','B','L','I','C','B','L','O','B',0}
  67 #define BCRYPT_RSAPRIVATE_BLOB   (const WCHAR []){'R','S','A','P','R','I','V','A','T','E','B','L','O','B',0}
  68
  69 #define MS_PRIMITIVE_PROVIDER (const WCHAR [])\
  70     {'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}
  71 #define MS_PLATFORM_CRYPTO_PROVIDER (const WCHAR [])\
  72     {'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}
  73
  74 #define BCRYPT_AES_ALGORITHM        (const WCHAR []){'A','E','S',0}
  75 #define BCRYPT_MD2_ALGORITHM        (const WCHAR []){'M','D','2',0}
  76 #define BCRYPT_MD4_ALGORITHM        (const WCHAR []){'M','D','4',0}
  77 #define BCRYPT_MD5_ALGORITHM        (const WCHAR []){'M','D','5',0}
  78 #define BCRYPT_RNG_ALGORITHM        (const WCHAR []){'R','N','G',0}
  79 #define BCRYPT_RSA_ALGORITHM        (const WCHAR []){'R','S','A',0}
  80 #define BCRYPT_SHA1_ALGORITHM       (const WCHAR []){'S','H','A','1',0}
  81 #define BCRYPT_SHA256_ALGORITHM     (const WCHAR []){'S','H','A','2','5','6',0}
  82 #define BCRYPT_SHA384_ALGORITHM     (const WCHAR []){'S','H','A','3','8','4',0}
  83 #define BCRYPT_SHA512_ALGORITHM     (const WCHAR []){'S','H','A','5','1','2',0}
  84 #define BCRYPT_ECDSA_P256_ALGORITHM (const WCHAR []){'E','C','D','S','A','_','P','2','5','6',0}
  85 #define BCRYPT_ECDSA_P384_ALGORITHM (const WCHAR []){'E','C','D','S','A','_','P','3','8','4',0}
  86 #define BCRYPT_ECDSA_P521_ALGORITHM (const WCHAR []){'E','C','D','S','A','_','P','5','2','1',0}
  87
  88 #define BCRYPT_CHAIN_MODE_NA        (const WCHAR []){'C','h','a','i','n','i','n','g','M','o','d','e','N','/','A',0}
  89 #define BCRYPT_CHAIN_MODE_CBC       (const WCHAR []){'C','h','a','i','n','i','n','g','M','o','d','e','C','B','C',0}
  90 #define BCRYPT_CHAIN_MODE_ECB       (const WCHAR []){'C','h','a','i','n','i','n','g','M','o','d','e','E','C','B',0}
  91 #define BCRYPT_CHAIN_MODE_CFB       (const WCHAR []){'C','h','a','i','n','i','n','g','M','o','d','e','C','F','B',0}
  92 #define BCRYPT_CHAIN_MODE_CCM       (const WCHAR []){'C','h','a','i','n','i','n','g','M','o','d','e','C','C','M',0}
  93 #define BCRYPT_CHAIN_MODE_GCM       (const WCHAR []){'C','h','a','i','n','i','n','g','M','o','d','e','G','C','M',0}
  94
  95 #define BCRYPT_ECDSA_PUBLIC_P256_MAGIC  0x31534345
  96 #define BCRYPT_ECDSA_PRIVATE_P256_MAGIC 0x32534345
  97 #define BCRYPT_ECDSA_PUBLIC_P384_MAGIC  0x33534345
  98 #define BCRYPT_ECDSA_PRIVATE_P384_MAGIC 0x34534345
  99 #define BCRYPT_ECDSA_PUBLIC_P521_MAGIC  0x35534345
 100 #define BCRYPT_ECDSA_PRIVATE_P521_MAGIC 0x36534345
 101
 102 typedef struct _BCRYPT_ALGORITHM_IDENTIFIER
 103 {
 104     LPWSTR pszName;
 105     ULONG  dwClass;
 106     ULONG  dwFlags;
 107 } BCRYPT_ALGORITHM_IDENTIFIER;
 108
 109 typedef struct __BCRYPT_KEY_LENGTHS_STRUCT
 110 {
 111     ULONG dwMinLength;
 112     ULONG dwMaxLength;
 113     ULONG dwIncrement;
 114 } BCRYPT_KEY_LENGTHS_STRUCT, BCRYPT_AUTH_TAG_LENGTHS_STRUCT;
 115
 116 typedef struct _BCRYPT_AUTHENTICATED_CIPHER_MODE_INFO
 117 {
 118     ULONG cbSize;
 119     ULONG dwInfoVersion;
 120     UCHAR *pbNonce;
 121     ULONG cbNonce;
 122     UCHAR *pbAuthData;
 123     ULONG cbAuthData;
 124     UCHAR *pbTag;
 125     ULONG cbTag;
 126     UCHAR *pbMacContext;
 127     ULONG cbMacContext;
 128     ULONG cbAAD;
 129     ULONGLONG cbData;
 130     ULONG dwFlags;
 131 } BCRYPT_AUTHENTICATED_CIPHER_MODE_INFO, *PBCRYPT_AUTHENTICATED_CIPHER_MODE_INFO;
 132
 133 typedef struct _BCRYPT_ECCKEY_BLOB
 134 {
 135     ULONG dwMagic;
 136     ULONG cbKey;
 137 } BCRYPT_ECCKEY_BLOB, *PBCRYPT_ECCKEY_BLOB;
 138
 139 #define BCRYPT_RSAPUBLIC_MAGIC      0x31415352
 140 #define BCRYPT_RSAPRIVATE_MAGIC     0x32415352
 141 #define BCRYPT_RSAFULLPRIVATE_MAGIC 0x33415352
 142
 143 typedef struct _BCRYPT_RSAKEY_BLOB
 144 {
 145     ULONG Magic;
 146     ULONG BitLength;
 147     ULONG cbPublicExp;
 148     ULONG cbModulus;
 149     ULONG cbPrime1;
 150     ULONG cbPrime2;
 151 } BCRYPT_RSAKEY_BLOB;
 152
 153 typedef struct _BCRYPT_PKCS1_PADDING_INFO
 154 {
 155     LPCWSTR pszAlgId;
 156 } BCRYPT_PKCS1_PADDING_INFO;
 157
 158 #define BCRYPT_PAD_NONE                     0x00000001
 159 #define BCRYPT_PAD_PKCS1                    0x00000002
 160 #define BCRYPT_PAD_OAEP                     0x00000004
 161 #define BCRYPT_PAD_PSS                      0x00000008
 162 #define BCRYPT_PAD_PKCS1_OPTIONAL_HASH_OID  0x00000010
 163
 164 #define BCRYPT_AUTHENTICATED_CIPHER_MODE_INFO_VERSION 1
 165
 166 #define BCRYPT_AUTH_MODE_CHAIN_CALLS_FLAG 0x00000001
 167 #define BCRYPT_AUTH_MODE_IN_PROGRESS_FLAG 0x00000002
 168
 169 typedef struct _CRYPT_INTERFACE_REG
 170 {
 171     ULONG dwInterface;
 172     ULONG dwFlags;
 173     ULONG cFunctions;
 174     PWSTR *rgpszFunctions;
 175 } CRYPT_INTERFACE_REG, *PCRYPT_INTERFACE_REG;
 176
 177 typedef struct _CRYPT_IMAGE_REG
 178 {
 179     PWSTR pszImage;
 180     ULONG cInterfaces;
 181     PCRYPT_INTERFACE_REG *rgpInterfaces;
 182 } CRYPT_IMAGE_REG, *PCRYPT_IMAGE_REG;
 183
 184 typedef struct _CRYPT_PROVIDER_REG
 185 {
 186     ULONG cAliases;
 187     PWSTR *rgpszAliases;
 188     PCRYPT_IMAGE_REG pUM;
 189     PCRYPT_IMAGE_REG pKM;
 190 } CRYPT_PROVIDER_REG, *PCRYPT_PROVIDER_REG;
 191
 192 typedef struct _BCRYPT_KEY_DATA_BLOB_HEADER
 193 {
 194     ULONG dwMagic;
 195     ULONG dwVersion;
 196     ULONG cbKeyData;
 197 } BCRYPT_KEY_DATA_BLOB_HEADER, *PBCRYPT_KEY_DATA_BLOB_HEADER;
 198
 199 #define BCRYPT_KEY_DATA_BLOB_MAGIC    0x4d42444b
 200 #define BCRYPT_KEY_DATA_BLOB_VERSION1 1
 201
 202 typedef PVOID BCRYPT_ALG_HANDLE;
 203 typedef PVOID BCRYPT_KEY_HANDLE;
 204 typedef PVOID BCRYPT_HANDLE;
 205 typedef PVOID BCRYPT_HASH_HANDLE;
 206
 207 /* Flags for BCryptGenRandom */
 208 #define BCRYPT_RNG_USE_ENTROPY_IN_BUFFER 0x00000001
 209 #define BCRYPT_USE_SYSTEM_PREFERRED_RNG  0x00000002
 210
 211 /* Flags for BCryptOpenAlgorithmProvider */
 212 #define BCRYPT_ALG_HANDLE_HMAC_FLAG 0x00000008
 213
 214 /* Flags for BCryptEncrypt/BCryptDecrypt */
 215 #define BCRYPT_BLOCK_PADDING        0x00000001
 216
 217 NTSTATUS WINAPI BCryptCloseAlgorithmProvider(BCRYPT_ALG_HANDLE, ULONG);
 218 NTSTATUS WINAPI BCryptCreateHash(BCRYPT_ALG_HANDLE, BCRYPT_HASH_HANDLE *, PUCHAR, ULONG, PUCHAR, ULONG, ULONG);
 219 NTSTATUS WINAPI BCryptDecrypt(BCRYPT_KEY_HANDLE, PUCHAR, ULONG, VOID *, PUCHAR, ULONG, PUCHAR, ULONG, ULONG *, ULONG);
 220 NTSTATUS WINAPI BCryptDestroyHash(BCRYPT_HASH_HANDLE);
 221 NTSTATUS WINAPI BCryptDestroyKey(BCRYPT_KEY_HANDLE);
 222 NTSTATUS WINAPI BCryptEncrypt(BCRYPT_KEY_HANDLE, PUCHAR, ULONG, VOID *, PUCHAR, ULONG, PUCHAR, ULONG, ULONG *, ULONG);
 223 NTSTATUS WINAPI BCryptEnumAlgorithms(ULONG, ULONG *, BCRYPT_ALGORITHM_IDENTIFIER **, ULONG);
 224 NTSTATUS WINAPI BCryptFinishHash(BCRYPT_HASH_HANDLE, PUCHAR, ULONG, ULONG);
 225 NTSTATUS WINAPI BCryptGenerateSymmetricKey(BCRYPT_ALG_HANDLE, BCRYPT_KEY_HANDLE *, PUCHAR, ULONG, PUCHAR, ULONG, ULONG);
 226 NTSTATUS WINAPI BCryptGenRandom(BCRYPT_ALG_HANDLE, PUCHAR, ULONG, ULONG);
 227 NTSTATUS WINAPI BCryptGetFipsAlgorithmMode(BOOLEAN *);
 228 NTSTATUS WINAPI BCryptGetProperty(BCRYPT_HANDLE, LPCWSTR, PUCHAR, ULONG, ULONG *, ULONG);
 229 NTSTATUS WINAPI BCryptHash(BCRYPT_ALG_HANDLE, PUCHAR, ULONG, PUCHAR, ULONG, PUCHAR, ULONG);
 230 NTSTATUS WINAPI BCryptHashData(BCRYPT_HASH_HANDLE, PUCHAR, ULONG, ULONG);
 231 NTSTATUS WINAPI BCryptImportKeyPair(BCRYPT_ALG_HANDLE, BCRYPT_KEY_HANDLE, LPCWSTR, BCRYPT_KEY_HANDLE *, UCHAR *, ULONG, ULONG);
 232 NTSTATUS WINAPI BCryptOpenAlgorithmProvider(BCRYPT_ALG_HANDLE *, LPCWSTR, LPCWSTR, ULONG);
 233 NTSTATUS WINAPI BCryptSetProperty(BCRYPT_HANDLE, LPCWSTR, PUCHAR, ULONG, ULONG);
 234 NTSTATUS WINAPI BCryptDuplicateHash(BCRYPT_HASH_HANDLE, BCRYPT_HASH_HANDLE *, UCHAR *, ULONG, ULONG);
 235 NTSTATUS WINAPI BCryptVerifySignature(BCRYPT_KEY_HANDLE, void *, UCHAR *, ULONG, UCHAR *, ULONG, ULONG);
 236
 237 #endif  /* __WINE_BCRYPT_H */