struktur WINHTTP_CERTIFICATE_INFO (winhttp.h)

Struktur WINHTTP_CERTIFICATE_INFO berisi informasi sertifikat yang dikembalikan dari server. Struktur ini digunakan oleh fungsi WinHttpQueryOption .

Sintaks

typedef struct _WINHTTP_CERTIFICATE_INFO {
  FILETIME ftExpiry;
  FILETIME ftStart;
  LPWSTR   lpszSubjectInfo;
  LPWSTR   lpszIssuerInfo;
  LPWSTR   lpszProtocolName;
  LPWSTR   lpszSignatureAlgName;
  LPWSTR   lpszEncryptionAlgName;
  DWORD    dwKeySize;
} WINHTTP_CERTIFICATE_INFO, *PWINHTTP_CERTIFICATE_INFO;

Anggota

ftExpiry

Struktur FILETIME yang berisi tanggal sertifikat kedaluwarsa.

ftStart

Struktur FILETIME yang berisi tanggal sertifikat menjadi valid.

lpszSubjectInfo

Penunjuk ke buffer yang berisi nama organisasi, situs, dan server tempat sertifikat dikeluarkan.

lpszIssuerInfo

Penunjuk ke buffer yang berisi nama organisasi, situs, dan server yang mengeluarkan sertifikat.

lpszProtocolName

Penunjuk ke buffer yang berisi nama protokol yang digunakan untuk menyediakan koneksi aman. Anggota ini tidak digunakan saat ini.

lpszSignatureAlgName

Penunjuk ke buffer yang berisi nama algoritma yang digunakan untuk menandatangani sertifikat. Anggota ini tidak digunakan saat ini.

lpszEncryptionAlgName

Pointer ke buffer yang berisi nama algoritma yang digunakan untuk melakukan enkripsi melalui koneksi saluran aman (SSL/TLS). Anggota ini tidak digunakan saat ini.

dwKeySize

Ukuran, dalam byte, dari kunci.

Keterangan

Struktur WINHTTP_CERTIFICATE_INFO berisi informasi tentang sertifikat yang dikembalikan oleh server saat koneksi menggunakan SSL/TLS. Fungsi WinHttpQueryOption mengembalikan struktur WINHTTP_CERTIFICATE_INFO saat parameter dwOption yang diteruskan ke fungsi WinHttpQueryOption diatur ke WINHTTP_OPTION_SECURITY_CERTIFICATE_STRUCT. Untuk informasi selengkapnya, lihat Bendera Opsi.

Fungsi WinHttpQueryOption tidak mengatur anggota lpszProtocolName, lpszSignatureAlgName, dan lpszEncryptionAlgName dari struktur WINHTTP_CERTIFICATE_INFO , sehingga anggota ini selalu dikembalikan sebagai NULL.

Setelah aplikasi tidak lagi memerlukan struktur WINHTTP_CERTIFICATE_INFO yang dikembalikan, fungsi LocalFree harus dipanggil untuk membebaskan pointer apa pun yang dikembalikan dalam struktur. Anggota struktur yang berisi pointer yang bukan NULL dan perlu dibebaskan adalah lpszSubjectInfo dan lpszIssuerInfo.

Catatan Untuk Windows XP dan Windows 2000, lihat bagian Persyaratan Run-Time dari halaman mulai Layanan HTTP Windows .

 

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP, Windows 2000 Professional dengan SP3 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003, Windows 2000 Server dengan SP3 [hanya aplikasi desktop]
Header	winhttp.h
Redistribusi	WinHTTP 5.0 dan Internet Explorer 5.01 atau yang lebih baru di Windows XP dan Windows 2000.

Lihat juga

Bendera Opsi

Versi WinHTTP

WinHttpQueryOption