Enumerazione WinHttpRequestOption

Articolo
06/03/2023

L'enumerazione WinHttpRequestOption include opzioni che possono essere impostate o recuperate per la sessione corrente di Microsoft Windows HTTP Services (WinHTTP).

Sintassi

typedef enum WinHttpRequestOption { 
  WinHttpRequestOption_UserAgentString,
  WinHttpRequestOption_URL,
  WinHttpRequestOption_URLCodePage,
  WinHttpRequestOption_EscapePercentInURL,
  WinHttpRequestOption_SslErrorIgnoreFlags,
  WinHttpRequestOption_SelectCertificate,
  WinHttpRequestOption_EnableRedirects,
  WinHttpRequestOption_UrlEscapeDisable,
  WinHttpRequestOption_UrlEscapeDisableQuery,
  WinHttpRequestOption_SecureProtocols,
  WinHttpRequestOption_EnableTracing,
  WinHttpRequestOption_RevertImpersonationOverSsl,
  WinHttpRequestOption_EnableHttpsToHttpRedirects,
  WinHttpRequestOption_EnablePassportAuthentication,
  WinHttpRequestOption_MaxAutomaticRedirects,
  WinHttpRequestOption_MaxResponseHeaderSize,
  WinHttpRequestOption_MaxResponseDrainSize,
  WinHttpRequestOption_EnableHttp1_1,
  WinHttpRequestOption_EnableCertificateRevocationCheck
} WinHttpRequestOption;

Costanti

WinHttpRequestOption_UserAgentString

Imposta o recupera un valore VARIANT contenente la stringa dell'agente utente .

WinHttpRequestOption_URL

Recupera un valore VARIANT che contiene l'URL della risorsa. Questo valore è di sola lettura; non è possibile impostare l'URL usando questa proprietà. L'URL non può essere letto finché non viene chiamato il metodo Open . Questa opzione è utile per controllare l'URL al termine del metodo Send per verificare che si sia verificato un reindirizzamento.

WinHttpRequestOption_URLCodePage

Imposta o recupera un valore VARIANT che identifica la tabella codici per la stringa URL. Il valore predefinito è la tabella codici UTF-8. La tabella codici viene usata per convertire la stringa dell'URL Unicode, passata nel metodo Open , in una rappresentazione di stringa a byte singolo.

WinHttpRequestOption_EscapePercentInURL

Imposta o recupera un valore VARIANT che indica se le percentuali di caratteri nella stringa URL vengono convertite in una sequenza di escape. Il valore predefinito di questa opzione è VARIANT_TRUE che specifica tutti i caratteri ANSI (American National Standards Institute) non sicuri, ad eccezione del simbolo di percentuale, vengono convertiti in una sequenza di escape.

WinHttpRequestOption_SslErrorIgnoreFlags

Imposta o recupera un valore VARIANT che indica quali errori del certificato del server devono essere ignorati. Può trattarsi di una combinazione di uno o più dei flag seguenti.

Errore	Valore
Autorità di certificazione (CA) sconosciuta o radice non attendibile	0x0100
Utilizzo errato	0x0200
Nome comune non valido	0x1000
Data o certificato scaduto non valido	0x2000

Il valore predefinito di questa opzione nella versione 5.1 di WinHTTP è zero, che non genera errori ignorati. Nelle versioni precedenti di WinHTTP, l'impostazione predefinita è stata 0x3300, che ha generato tutti gli errori del certificato del server ignorati per impostazione predefinita.

WinHttpRequestOption_SelectCertificate

Imposta un valore VARIANT che specifica il certificato client inviato a un server per l'autenticazione. Questa opzione indica il percorso, l'archivio certificati e l'oggetto di un certificato client delimitato da barre rovesciate. Per altre informazioni sulla selezione di un certificato client, vedere SSL in WinHTTP.

WinHttpRequestOption_EnableRedirects

Imposta o recupera un valore VARIANT che indica se le richieste vengono reindirizzate automaticamente quando il server specifica una nuova posizione per la risorsa. Il valore predefinito di questa opzione è VARIANT_TRUE per indicare che le richieste vengono reindirizzate automaticamente.

WinHttpRequestOption_UrlEscapeDisable

Imposta o recupera un valore VARIANT che indica se i caratteri non sicuri nel percorso e nei componenti di query di un URL vengono convertiti in sequenze di escape. Il valore predefinito di questa opzione è VARIANT_TRUE, che specifica che i caratteri nel percorso e nella query vengono convertiti.

WinHttpRequestOption_UrlEscapeDisableQuery

Imposta o recupera un valore VARIANT che indica se i caratteri non sicuri nel componente di query dell'URL vengono convertiti in sequenze di escape. Il valore predefinito di questa opzione è VARIANT_TRUE, che specifica che i caratteri nella query vengono convertiti.

WinHttpRequestOption_SecureProtocols

Imposta o recupera un valore VARIANT che indica quali protocolli sicuri possono essere utilizzati. Questa opzione seleziona i protocolli accettabili per il client. Il protocollo viene negoziato durante l'handshake Secure Sockets Layer (SSL). Può trattarsi di una combinazione di uno o più dei flag seguenti.

Protocollo	Valore
SSL 2.0	0x0008
SSL 3.0	0x0020
Transport Layer Security (TLS) 1.0	0x0080

Il valore predefinito di questa opzione è 0x0028, che indica che è possibile usare SSL 2.0 o SSL 3.0. Se questa opzione è impostata su zero, il client e il server non sono in grado di determinare un protocollo di sicurezza accettabile e il successivo invio genera un errore.

WinHttpRequestOption_EnableTracing

Imposta o recupera un valore VARIANT che indica se la traccia è attualmente abilitata. Vedi anche Raccogliere tracce WinHTTP.

WinHttpRequestOption_RevertImpersonationOverSsl

Controlla se l'oggetto WinHttpRequest ripristina temporaneamente la rappresentazione client per la durata delle operazioni di autenticazione del certificato SSL. L'impostazione predefinita per l'oggetto WinHttpRequest è TRUE. Impostare questa opzione su FALSE per mantenere la rappresentazione durante l'esecuzione di operazioni di autenticazione del certificato.

WinHttpRequestOption_EnableHttpsToHttpRedirects

Controlla se WinHTTP consente o meno i reindirizzamenti. Per impostazione predefinita, tutti i reindirizzamenti vengono seguiti automaticamente, ad eccezione di quelli che vengono trasferiti da un URL sicuro (https) a un URL non sicuro (http). Impostare questa opzione su TRUE per abilitare https ai reindirizzamenti HTTP.

WinHttpRequestOption_EnablePassportAuthentication

Abilita o disabilita il supporto per l'autenticazione passport. Per impostazione predefinita, il supporto automatico per l'autenticazione Passport è disabilitato; impostare questa opzione su TRUE per abilitare il supporto dell'autenticazione Passport.

WinHttpRequestOption_MaxAutomaticRedirects

Imposta o recupera il numero massimo di reindirizzamenti che WinHTTP segue; il valore predefinito è 10. Questo limite impedisce ai siti non autorizzati di bloccare il client WinHTTP dopo un numero elevato di reindirizzamenti.