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 MS_PRIMITIVE_PROVIDER (const WCHAR [])\
  62     {'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}
  63 #define MS_PLATFORM_CRYPTO_PROVIDER (const WCHAR [])\
  64     {'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}
  65
  66 #define BCRYPT_AES_ALGORITHM        (const WCHAR []){'A','E','S',0}
  67 #define BCRYPT_MD2_ALGORITHM        (const WCHAR []){'M','D','2',0}
  68 #define BCRYPT_MD4_ALGORITHM        (const WCHAR []){'M','D','4',0}
  69 #define BCRYPT_MD5_ALGORITHM        (const WCHAR []){'M','D','5',0}
  70 #define BCRYPT_RNG_ALGORITHM        (const WCHAR []){'R','N','G',0}
  71 #define BCRYPT_SHA1_ALGORITHM       (const WCHAR []){'S','H','A','1',0}
  72 #define BCRYPT_SHA256_ALGORITHM     (const WCHAR []){'S','H','A','2','5','6',0}
  73 #define BCRYPT_SHA384_ALGORITHM     (const WCHAR []){'S','H','A','3','8','4',0}
  74 #define BCRYPT_SHA512_ALGORITHM     (const WCHAR []){'S','H','A','5','1','2',0}
  75
  76 #define BCRYPT_CHAIN_MODE_NA        (const WCHAR []){'C','h','a','i','n','i','n','g','M','o','d','e','N','/','A',0}
  77 #define BCRYPT_CHAIN_MODE_CBC       (const WCHAR []){'C','h','a','i','n','i','n','g','M','o','d','e','C','B','C',0}
  78 #define BCRYPT_CHAIN_MODE_ECB       (const WCHAR []){'C','h','a','i','n','i','n','g','M','o','d','e','E','C','B',0}
  79 #define BCRYPT_CHAIN_MODE_CFB       (const WCHAR []){'C','h','a','i','n','i','n','g','M','o','d','e','C','F','B',0}
  80 #define BCRYPT_CHAIN_MODE_CCM       (const WCHAR []){'C','h','a','i','n','i','n','g','M','o','d','e','C','C','M',0}
  81 #define BCRYPT_CHAIN_MODE_GCM       (const WCHAR []){'C','h','a','i','n','i','n','g','M','o','d','e','G','C','M',0}
  82
  83 typedef struct _BCRYPT_ALGORITHM_IDENTIFIER
  84 {
  85     LPWSTR pszName;
  86     ULONG  dwClass;
  87     ULONG  dwFlags;
  88 } BCRYPT_ALGORITHM_IDENTIFIER;
  89
  90 typedef struct __BCRYPT_KEY_LENGTHS_STRUCT
  91 {
  92     ULONG dwMinLength;
  93     ULONG dwMaxLength;
  94     ULONG dwIncrement;
  95 } BCRYPT_KEY_LENGTHS_STRUCT;
  96
  97 typedef struct _CRYPT_INTERFACE_REG
  98 {
  99     ULONG dwInterface;
 100     ULONG dwFlags;
 101     ULONG cFunctions;
 102     PWSTR *rgpszFunctions;
 103 } CRYPT_INTERFACE_REG, *PCRYPT_INTERFACE_REG;
 104
 105 typedef struct _CRYPT_IMAGE_REG
 106 {
 107     PWSTR pszImage;
 108     ULONG cInterfaces;
 109     PCRYPT_INTERFACE_REG *rgpInterfaces;
 110 } CRYPT_IMAGE_REG, *PCRYPT_IMAGE_REG;
 111
 112 typedef struct _CRYPT_PROVIDER_REG
 113 {
 114     ULONG cAliases;
 115     PWSTR *rgpszAliases;
 116     PCRYPT_IMAGE_REG pUM;
 117     PCRYPT_IMAGE_REG pKM;
 118 } CRYPT_PROVIDER_REG, *PCRYPT_PROVIDER_REG;
 119
 120 typedef PVOID BCRYPT_ALG_HANDLE;
 121 typedef PVOID BCRYPT_KEY_HANDLE;
 122 typedef PVOID BCRYPT_HANDLE;
 123 typedef PVOID BCRYPT_HASH_HANDLE;
 124
 125 /* Flags for BCryptGenRandom */
 126 #define BCRYPT_RNG_USE_ENTROPY_IN_BUFFER 0x00000001
 127 #define BCRYPT_USE_SYSTEM_PREFERRED_RNG  0x00000002
 128
 129 /* Flags for BCryptOpenAlgorithmProvider */
 130 #define BCRYPT_ALG_HANDLE_HMAC_FLAG 0x00000008
 131
 132 /* Flags for BCryptEncrypt/BCryptDecrypt */
 133 #define BCRYPT_BLOCK_PADDING        0x00000001
 134
 135 NTSTATUS WINAPI BCryptCloseAlgorithmProvider(BCRYPT_ALG_HANDLE, ULONG);
 136 NTSTATUS WINAPI BCryptCreateHash(BCRYPT_ALG_HANDLE, BCRYPT_HASH_HANDLE *, PUCHAR, ULONG, PUCHAR, ULONG, ULONG);
 137 NTSTATUS WINAPI BCryptDecrypt(BCRYPT_KEY_HANDLE, PUCHAR, ULONG, VOID *, PUCHAR, ULONG, PUCHAR, ULONG, ULONG *, ULONG);
 138 NTSTATUS WINAPI BCryptDestroyHash(BCRYPT_HASH_HANDLE);
 139 NTSTATUS WINAPI BCryptDestroyKey(BCRYPT_KEY_HANDLE);
 140 NTSTATUS WINAPI BCryptEncrypt(BCRYPT_KEY_HANDLE, PUCHAR, ULONG, VOID *, PUCHAR, ULONG, PUCHAR, ULONG, ULONG *, ULONG);
 141 NTSTATUS WINAPI BCryptEnumAlgorithms(ULONG, ULONG *, BCRYPT_ALGORITHM_IDENTIFIER **, ULONG);
 142 NTSTATUS WINAPI BCryptFinishHash(BCRYPT_HASH_HANDLE, PUCHAR, ULONG, ULONG);
 143 NTSTATUS WINAPI BCryptGenerateSymmetricKey(BCRYPT_ALG_HANDLE, BCRYPT_KEY_HANDLE *, PUCHAR, ULONG, PUCHAR, ULONG, ULONG);
 144 NTSTATUS WINAPI BCryptGenRandom(BCRYPT_ALG_HANDLE, PUCHAR, ULONG, ULONG);
 145 NTSTATUS WINAPI BCryptGetFipsAlgorithmMode(BOOLEAN *);
 146 NTSTATUS WINAPI BCryptGetProperty(BCRYPT_HANDLE, LPCWSTR, PUCHAR, ULONG, ULONG *, ULONG);
 147 NTSTATUS WINAPI BCryptHash(BCRYPT_ALG_HANDLE, PUCHAR, ULONG, PUCHAR, ULONG, PUCHAR, ULONG);
 148 NTSTATUS WINAPI BCryptHashData(BCRYPT_HASH_HANDLE, PUCHAR, ULONG, ULONG);
 149 NTSTATUS WINAPI BCryptOpenAlgorithmProvider(BCRYPT_ALG_HANDLE *, LPCWSTR, LPCWSTR, ULONG);
 150 NTSTATUS WINAPI BCryptSetProperty(BCRYPT_HANDLE, LPCWSTR, PUCHAR, ULONG, ULONG);
 151 NTSTATUS WINAPI BCryptDuplicateHash(BCRYPT_HASH_HANDLE, BCRYPT_HASH_HANDLE *, UCHAR *, ULONG, ULONG);
 152
 153 #endif  /* __WINE_BCRYPT_H */