WinHttpRequestOption sabit listesi

WinHttpRequestOption numaralandırması, geçerli Microsoft Windows HTTP Hizmetleri (WinHTTP) oturumu için ayarlanabilen veya alınabilen seçenekler içerir.

Sözdizimi

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;

Sabitler

WinHttpRequestOption_UserAgentString

Kullanıcı aracısı dizesini içeren bir VARIANT ayarlar veya alır.

WinHttpRequestOption_URL

Kaynağın URL'sini içeren bir DEĞIŞKEN alır. Bu değer salt okunurdur; bu özelliği kullanarak URL'yi ayarlayamazsınız. Open yöntemi çağrılana kadar URL okunamaz. Bu seçenek, herhangi bir yeniden yönlendirmenin gerçekleştiğini doğrulamak için Send yöntemi tamamlandıktan sonra URL'yi denetlemek için kullanışlıdır.

WinHttpRequestOption_URLCodePage

URL dizesinin kod sayfasını tanımlayan bir VARIANT ayarlar veya alır. Varsayılan değer UTF-8 kod sayfasıdır. Kod sayfası, Open yönteminde geçirilen Unicode URL dizesini tek baytlık dize gösterimine dönüştürmek için kullanılır.

WinHttpRequestOption_EscapePercentInURL

URL dizesindeki yüzde karakterlerinin kaçış dizisine dönüştürüldüğünü belirten bir VARIANT ayarlar veya alır. Bu seçeneğin varsayılan değeri , yüzde simgesi bir kaçış dizisine dönüştürülmesi dışında tüm güvenli olmayan Amerikan Ulusal Standartlar Enstitüsü (ANSI) karakterlerini belirten VARIANT_TRUE.

WinHttpRequestOption_SslErrorIgnoreFlags

Hangi sunucu sertifikası hatalarının yoksayılması gerektiğini belirten bir VARIANT ayarlar veya alır. Bu, aşağıdaki bayraklardan birinin veya daha fazlasının birleşimi olabilir.

Hata	Değer
Bilinmeyen sertifika yetkilisi (CA) veya güvenilmeyen kök	0x0100
Yanlış kullanım	0x0200
Geçersiz ortak ad (CN)	0x1000
Geçersiz tarih veya sertifikanın süresi doldu	0x2000

WinHTTP sürüm 5.1'de bu seçeneğin varsayılan değeri sıfırdır ve hata yoksayılmamasıyla sonuçlanır. WinHTTP'nin önceki sürümlerinde varsayılan ayar 0x3300 ve bu da tüm sunucu sertifikası hatalarının varsayılan olarak yoksayılmasıyla sonuçlanıyordu.

WinHttpRequestOption_SelectCertificate

Kimlik doğrulaması için bir sunucuya gönderilen istemci sertifikasını belirten bir DEĞIŞKEN ayarlar. Bu seçenek, ters eğik çizgilerle sınırlandırılmış bir istemci sertifikasının konumunu, sertifika depounu ve konusunu gösterir. İstemci sertifikası seçme hakkında daha fazla bilgi için bkz. WinHTTP'de SSL.

WinHttpRequestOption_EnableRedirects

Sunucu kaynak için yeni bir konum belirttiğinde isteklerin otomatik olarak yeniden yönlendirilip yönlendirilmeyeceğini belirten bir VARIANT ayarlar veya alır. İsteklerin otomatik olarak yeniden yönlendirildiğini belirtmek için bu seçeneğin varsayılan değeri VARIANT_TRUE .

WinHttpRequestOption_UrlEscapeDisable

Bir URL'nin yol ve sorgu bileşenlerindeki güvenli olmayan karakterlerin kaçış dizilerine dönüştürüldüğünü belirten bir VARIANT ayarlar veya alır. Bu seçeneğin varsayılan değeri, yol ve sorgudaki karakterlerin dönüştürüldüğünü belirten VARIANT_TRUE değeridir.

WinHttpRequestOption_UrlEscapeDisableQuery

URL'nin sorgu bileşenindeki güvenli olmayan karakterlerin kaçış sıralarına dönüştürüldüğünü gösteren bir VARIANT ayarlar veya alır. Bu seçeneğin varsayılan değeri, sorgudaki karakterlerin dönüştürüldüğünü belirten VARIANT_TRUE değeridir.

WinHttpRequestOption_SecureProtocols

Hangi güvenli protokollerin kullanılabileceğini belirten bir VARIANT ayarlar veya alır. Bu seçenek, istemci tarafından kabul edilebilir protokolleri seçer. Protokol, Güvenli Yuva Katmanı (SSL) el sıkışması sırasında belirlenir. Bu, aşağıdaki bayraklardan birinin veya daha fazlasının birleşimi olabilir.

Protokol	Değer
SSL 2.0	0x0008
SSL 3.0	0x0020
Aktarım Katmanı Güvenliği (TLS) 1.0	0x0080

Bu seçeneğin varsayılan değeri, SSL 2.0 veya SSL 3.0'ın kullanılabileceğini gösteren 0x0028 değeridir. Bu seçenek sıfır olarak ayarlanırsa, istemci ve sunucu kabul edilebilir bir güvenlik protokolü belirleyemez ve bir sonraki Gönder hatasıyla sonuçlanır.

WinHttpRequestOption_EnableTracing

İzlemenin şu anda etkin olup olmadığını gösteren bir VARIANT ayarlar veya alır. Ayrıca bkz . WinHTTP izlemelerini toplama.

WinHttpRequestOption_RevertImpersonationOverSsl

WinHttpRequest nesnesinin SSL sertifikası kimlik doğrulama işlemleri süresi boyunca istemci kimliğine bürünme özelliğini geçici olarak geri alıp almayacağını denetler. WinHttpRequest nesnesi için varsayılan ayar TRUE'dır. Sertifika kimlik doğrulama işlemlerini gerçekleştirirken kimliğe bürünme özelliğini korumak için bu seçeneği YANLIŞ olarak ayarlayın.

WinHttpRequestOption_EnableHttpsToHttpRedirects

WinHTTP'nin yeniden yönlendirmelere izin verip vermediğini denetler. Varsayılan olarak, güvenli bir (https) URL'den güvenli olmayan (http) URL'ye aktarım yapanlar dışında tüm yeniden yönlendirmeler otomatik olarak takip edilir. HTTPS'den HTTP'ye yeniden yönlendirmeleri etkinleştirmek için bu seçeneği TRUE olarak ayarlayın.

WinHttpRequestOption_EnablePassportAuthentication

Passport kimlik doğrulaması desteğini etkinleştirir veya devre dışı bırakır. Varsayılan olarak, Passport kimlik doğrulaması için otomatik destek devre dışıdır; Passport kimlik doğrulaması desteğini etkinleştirmek için bu seçeneği TRUE olarak ayarlayın.

WinHttpRequestOption_MaxAutomaticRedirects

WinHTTP'nin izlediği en fazla yeniden yönlendirme sayısını ayarlar veya alır; varsayılan değer 10'dur. Bu sınır, yetkisiz sitelerin çok sayıda yeniden yönlendirmeden sonra WinHTTP istemcisini beklemeye almalarını önler.