crypto/capi_util.h

   1 // Copyright (c) 2011 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 #ifndef CRYPTO_CAPI_UTIL_H_
   6 #define CRYPTO_CAPI_UTIL_H_
   7 #pragma once
   8
   9 #include <windows.h>
  10 #include <wincrypt.h>
  11
  12 #include "crypto/crypto_export.h"
  13
  14 namespace crypto {
  15
  16 // CryptAcquireContext when passed CRYPT_NEWKEYSET or CRYPT_DELETEKEYSET in
  17 // flags is not thread-safe. For such calls, we create a global lock to
  18 // synchronize it.
  19 //
  20 // From "Threading Issues with Cryptographic Service Providers",
  21 // <http://msdn.microsoft.com/en-us/library/aa388149(v=VS.85).aspx>:
  22 //
  23 // "The CryptAcquireContext function is generally thread safe unless
  24 // CRYPT_NEWKEYSET or CRYPT_DELETEKEYSET is specified in the dwFlags
  25 // parameter."
  26 CRYPTO_EXPORT BOOL CryptAcquireContextLocked(HCRYPTPROV* prov,
  27                                              LPCWSTR container,
  28                                              LPCWSTR provider,
  29                                              DWORD prov_type,
  30                                              DWORD flags);
  31
  32 // Wrappers of malloc and free for CryptoAPI routines that need memory
  33 // allocators, such as in CRYPT_DECODE_PARA. Such routines require WINAPI
  34 // calling conventions.
  35 CRYPTO_EXPORT void* WINAPI CryptAlloc(size_t size);
  36 CRYPTO_EXPORT void WINAPI CryptFree(void* p);
  37
  38 }  // namespace crypto
  39
  40 #endif  // CRYPTO_CAPI_UTIL_H_