Share via

WINHTTP_CERTIFICATE_INFO-Struktur (winhttp.h)

  • Artikel

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.

Hinweis Informationen zu Windows XP und Windows 2000 finden Sie im Abschnitt Laufzeitanforderungen auf der Startseite der Windows-HTTP-Dienste .
 

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.

Weitere Informationen

Optionsflags

WinHTTP-Versionen

WinHttpQueryOption