Fungsi CryptGetDefaultOIDFunctionAddress (wincrypt.h)

  • Artikel

Fungsi CryptGetDefaultOIDFunctionAddress memuat DLL yang berisi alamat fungsi default. Ini juga dapat mengembalikan alamat fungsi pengidentifikasi objek default (OID) pertama atau berikutnya yang diinstal dalam set fungsi yang diinisialisasi dan memuat DLL yang berisi alamat fungsi tersebut.

Sintaks

BOOL CryptGetDefaultOIDFunctionAddress(
  [in]           HCRYPTOIDFUNCSET  hFuncSet,
  [in]           DWORD             dwEncodingType,
  [in, optional] LPCWSTR           pwszDll,
  [in]           DWORD             dwFlags,
  [out]          void              **ppvFuncAddr,
  [in, out]      HCRYPTOIDFUNCADDR *phFuncAddr
);

Parameter

[in] hFuncSet

Handel set fungsi yang sebelumnya diperoleh dari panggilan ke CryptInitOIDFunctionSet.

[in] dwEncodingType

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, optional] pwszDll

Nama DLL yang akan dimuat. Biasanya, nama DLL diperoleh dari daftar yang dikembalikan oleh CryptGetDefaultOIDDllList. Jika pwszDllADALAH NULL, pencarian dilakukan pada daftar fungsi default yang diinstal.

[in] dwFlags

Dicadangkan untuk penggunaan di masa mendatang dan harus nol.

[out] ppvFuncAddr

Penunjuk ke alamat fungsi pengembalian. Jika fungsi gagal, NULL dikembalikan dalam ppvFuncAddr.

[in, out] phFuncAddr

Digunakan hanya jika pwszDll ADALAH NULL. Pada panggilan pertama ke fungsi, *phFuncAddr harus NULL untuk memperoleh fungsi pertama yang diinstal.

Ketika fungsi ini berhasil, *phFuncAddr diatur ke handel fungsi. Jumlah referensi untuk handel fungsi bertambah.

Setelah panggilan pertama ke fungsi, phFuncAddr diatur ke penunjuk yang dikembalikan oleh panggilan sebelumnya. Penunjuk input ini selalu dikosongkan dalam fungsi melalui panggilan ke CryptFreeOIDFunctionAddress oleh fungsi ini. Panggilan untuk membebaskan pointer selalu dilakukan bahkan ketika fungsi utama mengembalikan kesalahan.

PhFuncAddrnon-NULL harus dirilis baik melalui panggilan ke CryptFreeOIDFunctionAddress atau dengan diteruskan kembali sebagai input ke fungsi ini atau sebagai input ke CryptGetOIDFunctionAddress.

Jika pwszDll bukan NULL, nilai parameter ini diabaikan dan penunjuk non-NULL tidak dikosongkan.

Mengembalikan nilai

Jika fungsi berhasil, fungsi mengembalikan bukan nol (TRUE).

Jika fungsi gagal, fungsi akan mengembalikan nol (FALSE).

Persyaratan

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

Lihat juga

Fungsi Dukungan OID