imported>LoreLiu 来自 2024年12月7日 (六) 06:08

2024-12-07T06:08:38Z

新页面

{{noteTA|G1=IT}}'''Cryptographic API''' (CryptoAPI) 是微軟在 Windows 作業系統中添加的密碼編譯機能，作為資料加密與解密功能的重要基礎，CryptoAPI 支援同步，非同步的金鑰加密處理，以及作業系統中的[[數位憑證]] 的管理工作。从[[Windows NT 4.0]]引入此功能，并在以后版本的操作系统中不断增强。

目前的 CryptoAPI 支援下列工作<ref>{{Cite web |url=http://msdn.microsoft.com/en-us/library/aa380239(VS.85).aspx |title=CryptoAPI System Architecture |accessdate=2008-09-01 |archive-date=2008-11-08 |archive-url=https://web.archive.org/web/20081108021813/http://msdn.microsoft.com/en-us/library/aa380239(VS.85).aspx |dead-url=no }}</ref>：

* 基礎[[密碼學]]函數。
** 內文函數 (Context function)。
** 金鑰產生函數 (Key generation function)。
** 金鑰交換函數 (Key Exchange function)。
* 憑證編碼與解碼函數（支援[[雜湊]]功能）。
* 憑證儲存函數。
* 簡單訊息函數。
** 加密與解密訊息與資料。
** 對訊息與資料進行簽章。
** 對收到的訊息與相關資料進行數位簽章驗證的檢查。
* 低階訊息函數。

由於 CryptoAPI 使用上過於複雜，因此微軟另外為 CryptoAPI 開發更為容易使用的 [[CAPICOM]] 元件<ref>{{Cite web |url=http://msdn.microsoft.com/en-us/library/aa380260(VS.85).aspx |title=Cryptography, CryptoAPI, and CAPICOM |accessdate=2008-09-01 |archive-date=2008-10-26 |archive-url=https://web.archive.org/web/20081026130832/http://msdn.microsoft.com/en-us/library/aa380260(VS.85).aspx |dead-url=no }}</ref>，以及 [[数据保护API|Data Protection API]]。从Windows Vista开始，推出了新一代密码学API [[Cryptography API: Next Generation]]。
==例子==
<syntaxhighlight lang="cpp">
#include <wincrypt.h>
#include <wintrust.h>
#pragma comment(lib, "crypt32.lib")

#include <atlstr.h>
bool GetHash(int hash_type, CString& hash_result, CString& hash_message)
{

HCRYPTPROV hCryptProv;
HCRYPTHASH hCryptHash;

/*Note that you will get the error such as ‘Invalid Algorithm Specified’ (Error Code: 0x80090008) when you try to replace the algorithm with CALG_SHA256, CALG_SHA384 or CALG_SHA512. Because these algorithms are not supported by Microsoft Base Cryptography Provider ( PROV_RSA_FULL ). To fix this problem you need to use the provider as PROV_RSA_AES (Microsoft Enhanced RSA and AES Cryptographic Provider) in the CryptAcquireContext function instead of PROV_RSA_FULL.*/
if (!CryptAcquireContext(&hCryptProv, NULL, MS_ENH_RSA_AES_PROV, PROV_RSA_AES, 0))
//&hCryptProv, NULL, MS_DEF_PROV, PROV_RSA_FULL, CRYPT_VERIFYCONTEXT))
{
unsigned int e = GetLastError();
CString str;
str.Format("创建CSP容器出错！错误代码为:%x！", e);
MessageBox(NULL, str, "出错啦!", MB_OK | MB_ICONERROR);
return false;
}

if (!CryptCreateHash(hCryptProv, hash_type, 0, 0, &hCryptHash))
{
DWORD e = GetLastError();
CString str;
str.Format("创建哈希句柄出错！错误代码为:%x！", e);
MessageBox(NULL, str, "出错啦!", MB_OK | MB_ICONERROR);
return false;
}

if (!CryptHashData(hCryptHash, (BYTE*)hash_message.GetBuffer(), hash_message.GetLength(), 0))
{
int e = GetLastError();
CString str;
str.Format("计算哈希值出错！错误代码为:%d！", e);
MessageBox(NULL, str, "出错啦!", MB_OK | MB_ICONERROR);
return false;
}

char hash_data[512];
DWORD hash_len = 512;
if (!CryptGetHashParam(hCryptHash, HP_HASHVAL, (BYTE*)hash_data, &hash_len, 0))
{
int e = GetLastError();
CString str;
str.Format("获取哈希值出错！错误代码为:%d！", e);
MessageBox(NULL, str, "出错啦!", MB_OK | MB_ICONERROR);
return false;
}

char hash_hex[512];
for (unsigned int i = 0; i <= hash_len - 1; i++)
{
int hash_bit = hash_data[i];
int first = (hash_bit & 0xf0) >> 4;
int second = hash_bit & 0x0f;
char tmp[2];
_itoa(first, tmp, 16);
hash_hex[i * 2] = tmp[0];
_itoa(second, tmp, 16);
hash_hex[i * 2 + 1] = tmp[0];
}

hash_hex[hash_len * 2] = '\0';
hash_result.Format("%s", hash_hex);
CryptDestroyHash(hCryptHash);
CryptReleaseContext(hCryptProv, NULL);
return true;
}
</syntaxhighlight>
== 參考資料 ==
<div class="references-small">
<references />
</div>

{{Microsoft APIs}}

[[Category:微軟]]
[[Category:Windows API]]
[[Category:網路安全]]

Cryptographic API - 版本历史

imported>LoreLiu 来自 2024年12月7日 (六) 06:08