CryptRegisterOIDInfo 関数 (wincrypt.h)

[アーティクル]
03/03/2024

CryptRegisterOIDInfo 関数は、CRYPT_OID_INFO構造体で指定された OID 情報を登録し、レジストリに保持します。

Crypt32.dll には、一般的に知られている OID に関する定義済みの情報が含まれています。この関数を使用すると、アプリケーションは定義済みの OID 情報を拡張できます。 CryptRegisterOIDInfo の最初の呼び出し中に、登録済みの OID 情報がインストールされます。

CryptRegisterOIDInfo を使用してテーブルを展開する場合、dwFlags によって制御される、定義済みのエントリの前または後に新しいエントリを配置できます。登録された OID 情報の配置は、テーブルが順番に検索されるため、 CryptFindOIDInfo の結果に影響します。事前定義済みエントリがチェックされる前に最初に登録されたエントリ、定義済みのエントリがチェックされ、最後に定義済みエントリがチェックされた後に登録されたエントリがチェックされます。最初に見つかった一致が返されます。定義済みエントリの前に配置された新しく登録されたエントリは、定義済みのエントリの 1 つをオーバーライドできます。

構文

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

パラメーター

[in] pInfo

登録する OID 情報を含むCRYPT_OID_INFO 構造体へのポインター。構造体の dwGroupId メンバーを設定して、OID 情報を登録するグループを指定します。

注

Cryptography API: Next Generation (CNG) で実装された Suite B アルゴリズムの OID 情報を登録する場合は、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 情報がインストールされます。

戻り値

関数が成功した場合、戻り値は 0 以外 (TRUE) になります。

関数が失敗した場合、戻り値は 0 (FALSE) になります。

注釈

OID 情報の使用が完了したら、 CryptUnregisterOIDInfo 関数を呼び出して登録を解除します。

要件

要件	値
サポートされている最小のクライアント	Windows XP (デスクトップアプリのみ)
サポートされている最小のサーバー	Windows Server 2003 (デスクトップアプリのみ)
対象プラットフォーム	Windows
ヘッダー	wincrypt.h
Library	Crypt32.lib
[DLL]	Crypt32.dll