WINHTTP_CERTIFICATE_INFO結構 (winHTTP.h)

WINHTTP_CERTIFICATE_INFO 結構包含從伺服器傳回的憑證資訊。 WinHttpQueryOption 函式會使用此結構。

語法

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;

成員

ftExpiry

包含憑證到期日期的 FILETIME 結構。

ftStart

包含憑證生效日期的 FILETIME 結構。

lpszSubjectInfo

緩衝區的指標，其中包含發行憑證的組織、網站和伺服器名稱。

lpszIssuerInfo

緩衝區的指標，其中包含發行憑證的組織、月臺和伺服器名稱。

lpszProtocolName

緩衝區的指標，其中包含用來提供安全連線的通訊協議名稱。 目前未使用這個成員。

lpszSignatureAlgName

緩衝區的指標，其中包含用來簽署憑證的演算法名稱。 目前未使用這個成員。

lpszEncryptionAlgName

緩衝區的指標，其中包含用來透過安全通道執行加密的演算法名稱， (SSL/TLS) 連線。 目前未使用這個成員。

dwKeySize

索引鍵的大小，以位元組為單位。

備註

WINHTTP_CERTIFICATE_INFO結構包含當連線使用 SSL/TLS 時，伺服器所傳回之憑證的相關信息。 當傳遞至 WinHttpQueryOption 函式的 dwOption 參數設定為 WINHTTP_OPTION_SECURITY_CERTIFICATE_STRUCT 時，WinHttpQueryOption 函式會傳回WINHTTP_CERTIFICATE_INFO結構。 如需詳細資訊，請參閱 選項旗標。

WinHttpQueryOption 函式不會設定 WINHTTP_CERTIFICATE_INFO 結構的 lpszProtocolName、lpszSignatureAlgName 和 lpszEncryptionAlgName 成員，因此這些成員一律會傳回為 NULL。

一旦應用程式不再需要傳回 的 WINHTTP_CERTIFICATE_INFO 結構， 則應該呼叫 LocalFree 函式以釋放結構中傳回的任何指標。 包含非 NULL 且需要釋放之指標的結構成員為 lpszSubjectInfo 和 lpszIssuerInfo。

注意針對 Windows XP 和 Windows 2000，請參閱 Windows HTTP 服務起始頁面的運行時間需求一節。

 

規格需求

需求	值
最低支援的用戶端	Windows XP、Windows 2000 Professional 與 SP3 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003、Windows 2000 Server 與 SP3 [僅限桌面應用程式]
標頭	winhttp.h
可轉散發套件	Windows XP 和 Windows 2000 上的 WinHTTP 5.0 和 Internet Explorer 5.01 或更新版本。

另請參閱

選項旗標

WinHTTP 版本

WinHttpQueryOption