Fungsi ImageGetCertificateData (imagehlp.h)

Artikel
02/29/2024

Mengambil sertifikat lengkap dari file.

Sintaks

BOOL IMAGEAPI ImageGetCertificateData(
  [in]      HANDLE            FileHandle,
  [in]      DWORD             CertificateIndex,
  [out]     LPWIN_CERTIFICATE Certificate,
  [in, out] PDWORD            RequiredLength
);

Parameter

[in] FileHandle

Handel ke file gambar. Handel ini harus dibuka untuk akses FILE_READ_DATA .

[in] CertificateIndex

Indeks sertifikat yang akan dikembalikan.

[out] Certificate

Penunjuk ke struktur WIN_CERTIFICATE yang menerima data sertifikat. Jika buffer tidak cukup besar untuk memuat struktur, fungsi gagal dan kode kesalahan terakhir diatur ke ERROR_INSUFFICIENT_BUFFER.

[in, out] RequiredLength

Pada input, parameter ini menentukan panjang buffer Sertifikat dalam byte. Jika berhasil, sertifikat akan menerima panjang sertifikat.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah TRUE.

Jika fungsi gagal, nilai yang dikembalikan adalah FALSE. Untuk mengambil informasi kesalahan yang diperluas, panggil GetLastError.

Keterangan

Struktur WIN_CERTIFICATE didefinisikan sebagai berikut:

typedef struct _WIN_CERTIFICATE {
    DWORD       dwLength;
    WORD        wRevision;
    WORD        wCertificateType;   // WIN_CERT_TYPE_xxx
    BYTE        bCertificate[ANYSIZE_ARRAY];
} WIN_CERTIFICATE, *LPWIN_CERTIFICATE;

Semua fungsi ImageHlp, seperti ini, adalah utas tunggal. Oleh karena itu, panggilan dari lebih dari satu utas ke fungsi ini kemungkinan akan mengakibatkan perilaku tak terduga atau kerusakan memori. Untuk menghindari hal ini, Anda harus menyinkronkan semua panggilan bersamaan dari lebih dari satu utas ke fungsi ini.

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	imagehlp.h
Pustaka	Imagehlp.lib
DLL	Imagehlp.dll

Lihat juga

ImageHlp Functions

Bagikan melalui