Fungsi CryptGetDefaultOIDDllList (wincrypt.h)

Artikel
08/27/2023

Fungsi CryptGetDefaultOIDDllList memperoleh daftar nama file DLL yang berisi fungsi pengidentifikasi objek default (OID) terdaftar untuk set fungsi dan jenis pengodean tertentu.

Sintaks

BOOL CryptGetDefaultOIDDllList(
  [in]      HCRYPTOIDFUNCSET hFuncSet,
  [in]      DWORD            dwEncodingType,
  [out]     WCHAR            *pwszDllList,
  [in, out] DWORD            *pcchDllList
);

Parameter

[in] hFuncSet

Set fungsi menangani yang sebelumnya diperoleh dengan panggilan ke CryptInitOIDFunctionSet.

[in] dwEncodingType

Menentukan tipe 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

Catatan Jenis pengodean sertifikat atau pesan diperlukan. X509_ASN_ENCODING adalah default. Jika jenis tersebut ditunjukkan, jenis tersebut digunakan; jika tidak, jika jenis PKCS7_ASN_ENCODING ditunjukkan, jenis tersebut digunakan.

[out] pwszDllList

Penunjuk ke buffer untuk menerima daftar nama file nol atau lebih yang dihentikan null. Daftar yang dikembalikan dihentikan dengan karakter NULL yang mengakhiri. Misalnya, daftar dua nama dapat berupa:

L"first.dll\0" L"second.dll\0" L"\0"

Untuk mengambil jumlah karakter lebar yang harus dipegang buffer, parameter ini bisa null. Untuk informasi selengkapnya, lihat Mengambil Data Dengan Panjang Tidak Diketahui.

[in, out] pcchDllList

Penunjuk ke DWORD yang menentukan ukuran, dalam karakter lebar, dari daftar yang dikembalikan yang diarahkan oleh parameter pwszDllList . Ketika fungsi kembali, variabel yang diacu oleh parameter pcchDllList berisi jumlah karakter lebar yang disimpan dalam buffer.

Catatan Saat memproses data yang dikembalikan dalam buffer, aplikasi perlu menggunakan ukuran aktual data yang dikembalikan. Ukuran aktual bisa sedikit lebih kecil dari ukuran buffer yang ditentukan pada input. Pada input, ukuran buffer biasanya ditentukan cukup besar untuk memastikan bahwa data output terbesar yang mungkin akan pas di buffer. Pada output, variabel yang diacu oleh parameter ini diperbarui untuk mencerminkan ukuran aktual data yang disalin ke buffer.

Nilai kembali

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

Jika fungsi gagal, fungsi mengembalikan nol (FALSE). Untuk informasi kesalahan yang diperluas, hubungi GetLastError.

Fungsi ini memiliki kode kesalahan berikut.

Menampilkan kode	Deskripsi
ERROR_MORE_DATA	Jika buffer yang ditentukan oleh parameter pwszDllList tidak cukup besar untuk menyimpan data yang dikembalikan, fungsi mengatur kode ERROR_MORE_DATA dan menyimpan ukuran buffer yang diperlukan, dalam karakter lebar, dalam variabel yang ditunjukkan oleh pcchDllList.

Persyaratan


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

Bagikan melalui