CryptRegisterOIDInfo 函式 (wincrypt.h)

發行項
03/03/2024

CryptRegisterOIDInfo 函式會註冊CRYPT_OID_INFO結構中指定的 OID 資訊，並將它保存在登錄中。

Crypt32.dll 包含常見已知 OID 的預先定義資訊。此函式可讓應用程式增強預先定義的 OID 資訊。在 CryptRegisterOIDInfo 第一次呼叫期間，會安裝已註冊的 OID 資訊。

使用 CryptRegisterOIDInfo 展開數據表時，可以在預先定義的專案之前或之後放置新的專案，由 dwFlags 控制。已註冊 OID 資訊的位置會影響 CryptFindOIDInfo 的結果，因為會依序搜尋數據表。先檢查預先定義專案之前放置的已註冊專案，然後會檢查預先定義的專案，最後檢查預先定義的項目之後所放置的已註冊專案。會傳回找到的第一個相符專案。在預先定義的專案之前放置新註冊的專案可以覆寫其中一個預先定義的專案。

語法

BOOL CryptRegisterOIDInfo(
  [in] PCCRYPT_OID_INFO pInfo,
  [in] DWORD            dwFlags
);

參數

[in] pInfo

具有要註冊之 OID 資訊的 CRYPT_OID_INFO 結構的指標。藉由設定結構的 dwGroupId 成員，指定要註冊 OID 資訊的群組。

注意

為使用密碼編譯 API 實作的 Suite B 演演算法註冊 OID 資訊：新一代 (CNG) 時，您必須將 CRYPT_OID_INFO 結構的 Algid 成員設定為CALG_OID_INFO_CNG_ONLY (0xFFFFFFFF) 。

[in] dwFlags

根據預設，註冊的 OID 資訊會在 Crypt32.dll 的 OID 專案之後安裝。如果已設定CRYPT_INSTALL_OID_INFO_BEFORE_FLAG，則會在 Crypt32.dll 的專案之前安裝新的OID資訊。

傳回值

如果函式成功，則傳回值為非零 (TRUE) 。

如果函式失敗，則傳回值為零， (FALSE) 。

備註

當您完成使用 OID 資訊時，請呼叫 CryptUnregisterOIDInfo 函式將其取消註冊。

規格需求

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
目標平台	Windows
標頭	wincrypt.h
程式庫	Crypt32.lib
Dll	Crypt32.dll