Fungsi CryptRegisterOIDFunction (wincrypt.h)

  • Artikel

Fungsi CryptRegisterOIDFunction mendaftarkan DLL yang berisi fungsi yang akan dipanggil untuk jenis pengodean, nama fungsi, dan pengidentifikasi objek (OID) yang ditentukan.

Secara default, nama fungsi baru diinstal di akhir daftar. Untuk mendaftarkan fungsi baru sebelum fungsi yang diinstal, panggil fungsi CryptSetOIDFunctionValue dengan dwValueType diatur ke REG_DWORD dan pwszValueName diatur ke CRYPT_OID_REG_FLAGS_VALUE_NAME.

CRYPT_OID_REG_FLAGS_VALUE_NAME didefinisikan sebagai L"CryptFlags".

Selain mendaftarkan DLL, nama fungsi yang akan dipanggil dapat ditimpa. Misalnya, parameter pszFuncName dapat diatur ke CryptDllEncodeObject dan parameter pszOverrideFuncName ke MyEncodeXyz. Bentuk baru CryptDllEncodeObject kemudian dapat disebut dengan menggunakan nama MyEncodeXyz. Ini memungkinkan DLL untuk mengekspor beberapa fungsi OID untuk nama fungsi yang sama tanpa perlu menginterpose fungsi dispatcher OID-nya sendiri.

Sintaks

BOOL CryptRegisterOIDFunction(
  [in] DWORD   dwEncodingType,
  [in] LPCSTR  pszFuncName,
  [in] LPCSTR  pszOID,
  [in] LPCWSTR pwszDll,
  [in] LPCSTR  pszOverrideFuncName
);

Parameter

[in] dwEncodingType

Menentukan jenis pengodean yang akan dicocokkan. Saat ini, hanya X509_ASN_ENCODING dan PKCS_7_ASN_ENCODING yang digunakan; namun, jenis pengodean tambahan dapat ditambahkan di masa mendatang. Untuk mencocokkan kedua jenis pengodean saat ini, gunakan:

X509_ASN_ENCODING | PKCS_7_ASN_ENCODING.

[in] pszFuncName

Nama fungsi yang sedang didaftarkan.

[in] pszOID

OID fungsi yang akan didaftarkan. Jika kata OID urutan tinggi bukan nol, pszOID adalah penunjuk ke string OID seperti "2.5.29.1" atau string ASCII seperti "file." Jika kata OID urutan tinggi adalah nol, kata urutan rendah menentukan pengidentifikasi numerik yang akan digunakan sebagai pengidentifikasi objek.

[in] pwszDll

Nama file DLL yang akan didaftarkan. Ini dapat berisi string variabel lingkungan yang akan diperluas dengan menggunakan fungsi ExpandEnvironmentStrings sebelum memuat DLL.

[in] pszOverrideFuncName

String yang menentukan nama untuk fungsi yang diekspor di DLL. Jika pszOverrideFuncName adalah NULL, nama fungsi yang ditentukan oleh pszFuncName digunakan.

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 fungsi OID, batalkan pendaftaran dengan memanggil fungsi CryptUnregisterOIDFunction .

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

Lihat juga

CryptSetOIDFunctionValue

CryptUnregisterOIDFunction

Fungsi Dukungan OID