Fungsi CertRetrieveLogoOrBiometricInfo (wincrypt.h)

  • Artikel

Fungsi CertRetrieveLogoOrBiometricInfo melakukan pengambilan URL informasi logo atau biometrik yang ditentukan dalam ekstensi sertifikat szOID_LOGOTYPE_EXT atau szOID_BIOMETRIC_EXT . Ekstensi szOID_BIOMETRIC_EXT (IETF RFC 3739) mendukung penambahan tanda tangan atau representasi bergambar dari pemegang sertifikat manusia. Ekstensi szOID_LOGOTYPE_EXT (IETF RFC 3709) mendukung penambahan representasi bergambar organisasi dalam sertifikat.

Sintaks

BOOL CertRetrieveLogoOrBiometricInfo(
  [in]  PCCERT_CONTEXT pCertContext,
  [in]  LPCSTR         lpszLogoOrBiometricType,
  [in]  DWORD          dwRetrievalFlags,
  [in]  DWORD          dwTimeout,
  [in]  DWORD          dwFlags,
        void           *pvReserved,
  [out] BYTE           **ppbData,
  [out] DWORD          *pcbData,
  [out] LPWSTR         *ppwszMimeType
);

Parameter

[in] pCertContext

Alamat struktur CERT_CONTEXT yang berisi sertifikat.

[in] lpszLogoOrBiometricType

Alamat string ANSI yang dihentikan null yang berisi string pengidentifikasi objek (OID) yang mengidentifikasi jenis informasi yang akan diambil.

Parameter ini mungkin juga berisi salah satu nilai yang telah ditentukan sebelumnya berikut.

Nilai Makna
CERT_RETRIEVE_ISSUER_LOGO
 Ambil jenis logo penerbit sertifikat.
CERT_RETRIEVE_SUBJECT_LOGO
 Ambil jenis logo subjek sertifikat.
CERT_RETRIEVE_COMMUNITY_LOGO
 Ambil jenis logo komunitas sertifikat.
CERT_RETRIEVE_BIOMETRIC_PICTURE_TYPE
 Ambil gambar yang terkait dengan sertifikat.
CERT_RETRIEVE_BIOMETRIC_SIGNATURE_TYPE
 Ambil tanda tangan yang terkait dengan sertifikat.

[in] dwRetrievalFlags

Sekumpulan bendera yang menentukan bagaimana informasi harus diambil. Parameter ini diteruskan sebagai dwRetrievalFlags dalam fungsi CryptRetrieveObjectByUrl .

[in] dwTimeout

Jumlah waktu maksimum, dalam milidetik, untuk menunggu pengambilan.

[in] dwFlags

Parameter ini tidak digunakan dan harus nol.

pvReserved

Parameter ini tidak digunakan dan harus NULL.

[out] ppbData

Alamat penunjuk BYTE yang menerima jenis logo atau data biometrik. Memori ini harus dibebaskan ketika tidak lagi diperlukan dengan meneruskan pointer ini ke fungsi CryptMemFree .

[out] pcbData

Alamat variabel DWORD yang menerima jumlah byte dalam buffer ppbData .

[out] ppwszMimeType

Alamat penunjuk ke string Unicode null-terminated yang menerima jenis Multipurpose Internet Mail Extensions (MIME) data. Parameter ini bisa NULL jika informasi ini tidak diperlukan. Memori ini harus dibebaskan ketika tidak lagi diperlukan dengan meneruskan pointer ini ke fungsi CryptMemFree .

Alamat ini selalu menerima NULL untuk jenis biometrik. Anda harus selalu memastikan bahwa parameter ini berisi alamat memori yang valid sebelum mencoba mengakses memori.

Nilai kembali

Mengembalikan bukan nol jika berhasil atau nol sebaliknya.

Untuk informasi kesalahan yang diperluas, hubungi GetLastError. Kemungkinan kode kesalahan yang dikembalikan oleh fungsi GetLastError termasuk, tetapi tidak terbatas pada, berikut ini.

Menampilkan kode Deskripsi
CRYPT_E_HASH_VALUE
 Nilai hash yang dihitung tidak cocok dengan nilai hash dalam sertifikat.
CRYPT_E_NOT_FOUND
 Sertifikat tidak berisi ekstensi szOID_LOGOTYPE_EXT atau szOID_BIOMETRIC_EXT , atau lpszLogoOrBiometricType yang ditentukan tidak ditemukan.
E_INVALIDARG
 Satu atau beberapa parameter tidak valid.
ERROR_INVALID_DATA
 Tidak ada data yang dapat diambil dari URL yang ditentukan oleh ekstensi sertifikat.
ERROR_NOT_SUPPORTED
 Sertifikat tidak mendukung ekstensi yang diperlukan.
NTE_BAD_ALGID
 Algoritma hash OID tidak diketahui.

Persyaratan

   
Klien minimum yang didukung Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 [hanya aplikasi desktop]
Target Platform Windows
Header wincrypt.h
Pustaka Crypt32.lib
DLL Crypt32.dll

Lihat juga

CryptMemFree