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
  65 #define MS_PRIMITIVE_PROVIDER (const WCHAR [])\
  66     {'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}
  67 #define MS_PLATFORM_CRYPTO_PROVIDER (const WCHAR [])\
  68     {'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}
  69
  70 #define BCRYPT_AES_ALGORITHM        (const WCHAR []){'A','E','S',0}
  71 #define BCRYPT_MD2_ALGORITHM        (const WCHAR []){'M','D','2',0}
  72 #define BCRYPT_MD4_ALGORITHM        (const WCHAR []){'M','D','4',0}
  73 #define BCRYPT_MD5_ALGORITHM        (const WCHAR []){'M','D','5',0}
  74 #define BCRYPT_RNG_ALGORITHM        (const WCHAR []){'R','N','G',0}
  75 #define BCRYPT_SHA1_ALGORITHM       (const WCHAR []){'S','H','A','1',0}
  76 #define BCRYPT_SHA256_ALGORITHM     (const WCHAR []){'S','H','A','2','5','6',0}
  77 #define BCRYPT_SHA384_ALGORITHM     (const WCHAR []){'S','H','A','3','8','4',0}
  78 #define BCRYPT_SHA512_ALGORITHM     (const WCHAR []){'S','H','A','5','1','2',0}
  79
  80 #define BCRYPT_CHAIN_MODE_NA        (const WCHAR []){'C','h','a','i','n','i','n','g','M','o','d','e','N','/','A',0}
  81 #define BCRYPT_CHAIN_MODE_CBC       (const WCHAR []){'C','h','a','i','n','i','n','g','M','o','d','e','C','B','C',0}
  82 #define BCRYPT_CHAIN_MODE_ECB       (const WCHAR []){'C','h','a','i','n','i','n','g','M','o','d','e','E','C','B',0}
  83 #define BCRYPT_CHAIN_MODE_CFB       (const WCHAR []){'C','h','a','i','n','i','n','g','M','o','d','e','C','F','B',0}
  84 #define BCRYPT_CHAIN_MODE_CCM       (const WCHAR []){'C','h','a','i','n','i','n','g','M','o','d','e','C','C','M',0}
  85 #define BCRYPT_CHAIN_MODE_GCM       (const WCHAR []){'C','h','a','i','n','i','n','g','M','o','d','e','G','C','M',0}
  86
  87 typedef struct _BCRYPT_ALGORITHM_IDENTIFIER
  88 {
  89     LPWSTR pszName;
  90     ULONG  dwClass;
  91     ULONG  dwFlags;
  92 } BCRYPT_ALGORITHM_IDENTIFIER;
  93
  94 typedef struct __BCRYPT_KEY_LENGTHS_STRUCT
  95 {
  96     ULONG dwMinLength;
  97     ULONG dwMaxLength;
  98     ULONG dwIncrement;
  99 } BCRYPT_KEY_LENGTHS_STRUCT, BCRYPT_AUTH_TAG_LENGTHS_STRUCT;
 100
 101 typedef struct _BCRYPT_AUTHENTICATED_CIPHER_MODE_INFO
 102 {
 103     ULONG cbSize;
 104     ULONG dwInfoVersion;
 105     UCHAR *pbNonce;
 106     ULONG cbNonce;
 107     UCHAR *pbAuthData;
 108     ULONG cbAuthData;
 109     UCHAR *pbTag;
 110     ULONG cbTag;
 111     UCHAR *pbMacContext;
 112     ULONG cbMacContext;
 113     ULONG cbAAD;
 114     ULONGLONG cbData;
 115     ULONG dwFlags;
 116 } BCRYPT_AUTHENTICATED_CIPHER_MODE_INFO, *PBCRYPT_AUTHENTICATED_CIPHER_MODE_INFO;
 117
 118 #define BCRYPT_AUTHENTICATED_CIPHER_MODE_INFO_VERSION 1
 119
 120 #define BCRYPT_AUTH_MODE_CHAIN_CALLS_FLAG 0x00000001
 121 #define BCRYPT_AUTH_MODE_IN_PROGRESS_FLAG 0x00000002
 122
 123 typedef struct _CRYPT_INTERFACE_REG
 124 {
 125     ULONG dwInterface;
 126     ULONG dwFlags;
 127     ULONG cFunctions;
 128     PWSTR *rgpszFunctions;
 129 } CRYPT_INTERFACE_REG, *PCRYPT_INTERFACE_REG;
 130
 131 typedef struct _CRYPT_IMAGE_REG
 132 {
 133     PWSTR pszImage;
 134     ULONG cInterfaces;
 135     PCRYPT_INTERFACE_REG *rgpInterfaces;
 136 } CRYPT_IMAGE_REG, *PCRYPT_IMAGE_REG;
 137
 138 typedef struct _CRYPT_PROVIDER_REG
 139 {
 140     ULONG cAliases;
 141     PWSTR *rgpszAliases;
 142     PCRYPT_IMAGE_REG pUM;
 143     PCRYPT_IMAGE_REG pKM;
 144 } CRYPT_PROVIDER_REG, *PCRYPT_PROVIDER_REG;
 145
 146 typedef struct _BCRYPT_KEY_DATA_BLOB_HEADER
 147 {
 148     ULONG dwMagic;
 149     ULONG dwVersion;
 150     ULONG cbKeyData;
 151 } BCRYPT_KEY_DATA_BLOB_HEADER, *PBCRYPT_KEY_DATA_BLOB_HEADER;
 152
 153 #define BCRYPT_KEY_DATA_BLOB_MAGIC    0x4d42444b
 154 #define BCRYPT_KEY_DATA_BLOB_VERSION1 1
 155
 156 typedef PVOID BCRYPT_ALG_HANDLE;
 157 typedef PVOID BCRYPT_KEY_HANDLE;
 158 typedef PVOID BCRYPT_HANDLE;
 159 typedef PVOID BCRYPT_HASH_HANDLE;
 160
 161 /* Flags for BCryptGenRandom */
 162 #define BCRYPT_RNG_USE_ENTROPY_IN_BUFFER 0x00000001
 163 #define BCRYPT_USE_SYSTEM_PREFERRED_RNG  0x00000002
 164
 165 /* Flags for BCryptOpenAlgorithmProvider */
 166 #define BCRYPT_ALG_HANDLE_HMAC_FLAG 0x00000008
 167
 168 /* Flags for BCryptEncrypt/BCryptDecrypt */
 169 #define BCRYPT_BLOCK_PADDING        0x00000001
 170
 171 NTSTATUS WINAPI BCryptCloseAlgorithmProvider(BCRYPT_ALG_HANDLE, ULONG);
 172 NTSTATUS WINAPI BCryptCreateHash(BCRYPT_ALG_HANDLE, BCRYPT_HASH_HANDLE *, PUCHAR, ULONG, PUCHAR, ULONG, ULONG);
 173 NTSTATUS WINAPI BCryptDecrypt(BCRYPT_KEY_HANDLE, PUCHAR, ULONG, VOID *, PUCHAR, ULONG, PUCHAR, ULONG, ULONG *, ULONG);
 174 NTSTATUS WINAPI BCryptDestroyHash(BCRYPT_HASH_HANDLE);
 175 NTSTATUS WINAPI BCryptDestroyKey(BCRYPT_KEY_HANDLE);
 176 NTSTATUS WINAPI BCryptEncrypt(BCRYPT_KEY_HANDLE, PUCHAR, ULONG, VOID *, PUCHAR, ULONG, PUCHAR, ULONG, ULONG *, ULONG);
 177 NTSTATUS WINAPI BCryptEnumAlgorithms(ULONG, ULONG *, BCRYPT_ALGORITHM_IDENTIFIER **, ULONG);
 178 NTSTATUS WINAPI BCryptFinishHash(BCRYPT_HASH_HANDLE, PUCHAR, ULONG, ULONG);
 179 NTSTATUS WINAPI BCryptGenerateSymmetricKey(BCRYPT_ALG_HANDLE, BCRYPT_KEY_HANDLE *, PUCHAR, ULONG, PUCHAR, ULONG, ULONG);
 180 NTSTATUS WINAPI BCryptGenRandom(BCRYPT_ALG_HANDLE, PUCHAR, ULONG, ULONG);
 181 NTSTATUS WINAPI BCryptGetFipsAlgorithmMode(BOOLEAN *);
 182 NTSTATUS WINAPI BCryptGetProperty(BCRYPT_HANDLE, LPCWSTR, PUCHAR, ULONG, ULONG *, ULONG);
 183 NTSTATUS WINAPI BCryptHash(BCRYPT_ALG_HANDLE, PUCHAR, ULONG, PUCHAR, ULONG, PUCHAR, ULONG);
 184 NTSTATUS WINAPI BCryptHashData(BCRYPT_HASH_HANDLE, PUCHAR, ULONG, ULONG);
 185 NTSTATUS WINAPI BCryptOpenAlgorithmProvider(BCRYPT_ALG_HANDLE *, LPCWSTR, LPCWSTR, ULONG);
 186 NTSTATUS WINAPI BCryptSetProperty(BCRYPT_HANDLE, LPCWSTR, PUCHAR, ULONG, ULONG);
 187 NTSTATUS WINAPI BCryptDuplicateHash(BCRYPT_HASH_HANDLE, BCRYPT_HASH_HANDLE *, UCHAR *, ULONG, ULONG);
 188
 189 #endif  /* __WINE_BCRYPT_H */