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_api.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_API BOOL CryptAcquireContextLocked(HCRYPTPROV* prov,
  27                                           LPCWSTR container,
  28                                           LPCWSTR provider,
  29                                           DWORD prov_type,
  30                                           DWORD flags);
  31
  32 }  // namespace crypto
  33
  34 #endif  // CRYPTO_CAPI_UTIL_H_