WINHTTP_CERTIFICATE_INFO struttura (winhttp.h)
La struttura WINHTTP_CERTIFICATE_INFO contiene informazioni sul certificato restituite dal server. Questa struttura viene usata dalla funzione WinHttpQueryOption .
Sintassi
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;
Members
ftExpiry
Struttura FILETIME contenente la data di scadenza del certificato.
ftStart
Struttura FILETIME contenente la data di validità del certificato.
lpszSubjectInfo
Puntatore a un buffer contenente il nome dell'organizzazione, del sito e del server per cui è stato rilasciato il certificato.
lpszIssuerInfo
Puntatore a un buffer contenente il nome dell'organizzazione, del sito e del server che ha rilasciato il certificato.
lpszProtocolName
Puntatore a un buffer contenente il nome del protocollo usato per fornire la connessione sicura. Questo membro non è corrente.
lpszSignatureAlgName
Puntatore a un buffer contenente il nome dell'algoritmo usato per firmare il certificato. Questo membro non è corrente.
lpszEncryptionAlgName
Puntatore a un buffer contenente il nome dell'algoritmo usato per eseguire la crittografia tramite la connessione SSL/TLS (Secure Channel). Questo membro non è corrente.
dwKeySize
Dimensioni, in byte, della chiave.
Commenti
La struttura WINHTTP_CERTIFICATE_INFO contiene informazioni sul certificato restituito dal server quando la connessione usa SSL/TLS. La funzione WinHttpQueryOption restituisce la struttura WINHTTP_CERTIFICATE_INFO quando il parametro dwOption passato alla funzione WinHttpQueryOption è impostato su WINHTTP_OPTION_SECURITY_CERTIFICATE_STRUCT. Per altre informazioni, vedere Flag di opzione.
La funzione WinHttpQueryOption non imposta i membri lpszProtocolName, lpszSignatureAlgName e lpszEncryptionAlgName della struttura WINHTTP_CERTIFICATE_INFO , pertanto questi membri vengono sempre restituiti come NULL.
Una volta che l'applicazione non ha più bisogno della struttura WINHTTP_CERTIFICATE_INFO restituita, la funzione LocalFree deve essere chiamata per liberare qualsiasi puntatore restituito nella struttura. I membri della struttura contenenti puntatori non NULL e devono essere liberati sono lpszSubjectInfo e lpszIssuerInfo.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP, Windows 2000 Professional con SP3 [solo app desktop] |
| Server minimo supportato | Windows Server 2003, Windows 2000 Server con SP3 [solo app desktop] |
| Intestazione | winhttp.h |
| Componente ridistribuibile | WinHTTP 5.0 e Internet Explorer 5.01 o versione successiva in Windows XP e Windows 2000. |