WINHTTP_CERTIFICATE_INFO-Struktur (winhttp.h)
Die WINHTTP_CERTIFICATE_INFO-Struktur enthält Zertifikatinformationen, die vom Server zurückgegeben werden. Diese Struktur wird von der WinHttpQueryOption-Funktion verwendet.
Syntax
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;
Member
ftExpiry
Eine FILETIME-Struktur , die das Ablaufdatum des Zertifikats enthält.
ftStart
Eine FILETIME-Struktur , die das Datum enthält, an dem das Zertifikat gültig wird.
lpszSubjectInfo
Ein Zeiger auf einen Puffer, der den Namen des organization, Standorts und Servers enthält, für den das Zertifikat ausgestellt wurde.
lpszIssuerInfo
Ein Zeiger auf einen Puffer, der den Namen des organization, Standorts und Servers enthält, der das Zertifikat ausgestellt hat.
lpszProtocolName
Ein Zeiger auf einen Puffer, der den Namen des Protokolls enthält, das zum Bereitstellen der sicheren Verbindung verwendet wird. Dieser Member wird nicht aktuell verwendet.
lpszSignatureAlgName
Ein Zeiger auf einen Puffer, der den Namen des Algorithmus enthält, der zum Signieren des Zertifikats verwendet wird. Dieser Member wird nicht aktuell verwendet.
lpszEncryptionAlgName
Ein Zeiger auf einen Puffer, der den Namen des Algorithmus enthält, der zum Ausführen der Verschlüsselung über die SSL/TLS-Verbindung (Secure Channel) verwendet wird. Dieser Member wird nicht aktuell verwendet.
dwKeySize
Die Größe des Schlüssels in Bytes.
Hinweise
Die WINHTTP_CERTIFICATE_INFO-Struktur enthält Informationen zum Zertifikat, das vom Server zurückgegeben wird, wenn die Verbindung SSL/TLS verwendet. Die WinHttpQueryOption-Funktion gibt die WINHTTP_CERTIFICATE_INFO-Struktur zurück, wenn der an die WinHttpQueryOption-Funktion übergebene dwOption-Parameter auf WINHTTP_OPTION_SECURITY_CERTIFICATE_STRUCT festgelegt ist. Weitere Informationen finden Sie unter Optionsflags.
Die WinHttpQueryOption-Funktion legt die Elemente lpszProtocolName, lpszSignatureAlgName und lpszEncryptionAlgName der WINHTTP_CERTIFICATE_INFO-Struktur nicht fest, sodass diese Member immer als NULL zurückgegeben werden.
Sobald die Anwendung die zurückgegebene WINHTTP_CERTIFICATE_INFO-Struktur nicht mehr benötigt, sollte die LocalFree-Funktion aufgerufen werden, um alle in der Struktur zurückgegebenen Zeiger freizugeben. Die Strukturmember, die Zeiger enthalten, die nicht NULL sind und freigegeben werden müssen, sind lpszSubjectInfo und lpszIssuerInfo.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP, Windows 2000 Professional mit SP3 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003, Windows 2000 Server mit SP3 [nur Desktop-Apps] |
| Kopfzeile | winhttp.h |
| Verteilbare Komponente | WinHTTP 5.0 und Internet Explorer 5.01 oder höher unter Windows XP und Windows 2000. |