Fungsi CryptRegisterOIDInfo (wincrypt.h)

Artikel
08/27/2023

Fungsi CryptRegisterOIDInfo mendaftarkan informasi OID yang ditentukan dalam struktur CRYPT_OID_INFO , mempertahankannya ke registri.

Crypt32.dll berisi informasi yang telah ditentukan sebelumnya untuk OID yang umum diketahui. Fungsi ini memungkinkan aplikasi untuk menambah informasi OID yang telah ditentukan sebelumnya. Selama panggilan pertama CryptRegisterOIDInfo, informasi OID terdaftar diinstal.

Saat memperluas tabel menggunakan CryptRegisterOIDInfo, entri baru dapat ditempatkan baik sebelum atau sesudah entri yang telah ditentukan sebelumnya, dikendalikan oleh dwFlags. Penempatan informasi OID terdaftar memengaruhi hasil CryptFindOIDInfo karena tabel dicari secara berurutan. Entri terdaftar pertama yang ditempatkan sebelum entri yang telah ditentukan diperiksa, kemudian entri yang telah ditentukan diperiksa, dan akhirnya, entri terdaftar ditempatkan setelah entri yang telah ditentukan diperiksa. Kecocokan pertama yang ditemukan dikembalikan. Entri yang baru didaftarkan yang ditempatkan sebelum entri yang telah ditentukan sebelumnya dapat menimpa salah satu entri yang telah ditentukan sebelumnya.

Sintaks

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

Parameter

[in] pInfo

Penunjuk ke struktur CRYPT_OID_INFO dengan informasi OID untuk mendaftar. Tentukan grup tempat informasi OID didaftarkan dengan mengatur anggota dwGroupId struktur.

Catatan

Saat mendaftarkan informasi OID untuk algoritma Suite B yang diterapkan dengan Cryptography API: Next Generation (CNG), Anda harus mengatur anggota Algid dari struktur CRYPT_OID_INFO ke CALG_OID_INFO_CNG_ONLY (0xFFFFFFFF).

[in] dwFlags

Secara default, informasi OID terdaftar diinstal setelah entri OID Crypt32.dll. Jika CRYPT_INSTALL_OID_INFO_BEFORE_FLAG diatur, informasi OID baru diinstal sebelum entri Crypt32.dll.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan bukan nol (TRUE).

Jika fungsi gagal, nilai yang dikembalikan adalah nol (FALSE).

Keterangan

Setelah Anda selesai menggunakan informasi OID, batalkan pendaftaran dengan memanggil fungsi CryptUnregisterOIDInfo .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	wincrypt.h
Pustaka	Crypt32.lib
DLL	Crypt32.dll