Beállításjelzők

A WinHttpQueryOption és a WinHttpSetOption az alábbi beállításjelzőket támogatja.

WINHTTP_OPTION_ASSURED_NON_BLOCKING_CALLBACKS

Az alapértelmezett érték HAMIS. Ha IGAZ értékre van állítva, a WinHTTP nem garantálja az előrehaladást, ha az ügyfélalkalmazás letiltja az állapotvisszahívásokat.

Az ügyfélalkalmazásnak különös figyelmet kell fordítania arra, hogy a visszahíváson belül minimális műveleteket hajt végre blokkolás nélkül, a lehető leggyorsabban visszatérve, és különösen ne várjon a későbbi WinHTTP-hívásokra. Ha nem követi ezeket az irányelveket, valószínűleg negatív hatással van a teljesítményre, vagy egy lehetséges alkalmazás lefagy. Ha az előírt módon használják, ez a beállítás javíthatja a teljesítményt.

WINHTTP_OPTION_AUTOLOGON_POLICY

Egy aláíratlan hosszú egész számot állít be, amely az automatikus bejelentkezési szabályzatot az alábbi értékek egyikével határozza meg.

Időszak	Leírás
WINHTTP_AUTOLOGON_SECURITY_LEVEL_HIGH	A rendszer nem használja az alapértelmezett hitelesítő adatokat. Vegye figyelembe, hogy ez a jelző csak akkor lép érvénybe, ha a kiszolgálót a tényleges gépnév alapján adja meg. Ez nem lép érvénybe, ha a kiszolgálót a "localhost" vagy az IP-cím alapján adja meg.
WINHTTP_AUTOLOGON_SECURITY_LEVEL_LOW	A rendszer az alapértelmezett hitelesítő adatokkal hitelesített bejelentkezést hajt végre az összes kéréshez.
WINHTTP_AUTOLOGON_SECURITY_LEVEL_MEDIUM	Az alapértelmezett hitelesítő adatokkal végzett hitelesített bejelentkezések csak a helyi intraneten lévő kérések esetén lesznek végrehajtva.

WINHTTP_OPTION_BACKGROUND_CONNECTIONS

Amikor ezt a beállítást egy munkamenet-leíróra állítja, meg kell adnia a megnyitni kívánt kapcsolatok számát. Ezután, amikor először elküld egy kérést, ahelyett, hogy csak egyetlen kapcsolatot nyit meg, a WinHttp számos kapcsolatot nyit meg párhuzamosan. Ez javíthatja ugyanahhoz a célhelyhez érkező későbbi kérések teljesítményét, ami nem jár majd a kapcsolat létesítésének többletterhelésével.

WINHTTP_OPTION_CALLBACK

Lekéri az egérmutatót a WinHttpSetStatusCallbacktel beállított visszahívási függvényhez.

WINHTTP_OPTION_CLIENT_CERT_CONTEXT

Beállítja az ügyféltanúsítvány-környezetet. Ha egy alkalmazás ERROR_WINHTTP_CLIENT_AUTH_CERT_NEEDED kap, a kérés újrapróbálkozása előtt meg kell hívnia a WinHttpSetOptiont , hogy adjon meg egy tanúsítványt. A beállítás feldolgozásának részeként a WinHttp meghívja a CertDuplicateCertificateContextet a hívó által biztosított tanúsítványkörnyezetben, hogy a tanúsítványkörnyezetet a hívó egymástól függetlenül kiadhassa.

Megjegyzés:

Az alkalmazás nem kísérelheti meg bezárni a tanúsítványtárolót az CERT_CLOSE_STORE_FORCE_FLAG jelzővel azon tanúsítványtároló certCloseStore hívásában, amelyből a tanúsítványkörnyezetet lekérte. Hozzáférési szabálysértés léphet fel.

Amikor a kiszolgáló ügyféltanúsítványt kér, a WinHttpSendRequest vagy a WinHttpReceiveResponseERROR_WINHTTP_CLIENT_AUTH_CERT_NEEDED hibát ad vissza. Ha a kiszolgáló kéri a tanúsítványt, de nincs rá szükség, az alkalmazás megadhatja ezt a beállítást, hogy jelezze, hogy nincs tanúsítványa. A kiszolgáló másik hitelesítési sémát választhat, vagy névtelen hozzáférést engedélyezhet a kiszolgálóhoz. Az alkalmazás a WinHttpSetOptionlpBuffer paraméterében biztosítja a WINHTTP_NO_CLIENT_CERT_CONTEXT makrót az alábbi kódpéldában látható módon.

BOOL fRet = WinHttpSetOption(hRequest,
                             WINHTTP_OPTION_CLIENT_CERT_CONTEXT,
                             WINHTTP_NO_CLIENT_CERT_CONTEXT,
                             0);

Ha a kiszolgáló ügyféltanúsítványt igényel, 403 HTTP-állapotkódot küldhet válaszul. További információ: WINHTTP_OPTION_CLIENT_CERT_ISSUER_LIST lehetőség.

WINHTTP_OPTION_CLIENT_CERT_ISSUER_LIST

Egy SecPkgContext_IssuerListInfoEx struktúrát kér le, ha a WinHttpSendRequest vagy a WinHttpReceiveResponse hiba ERROR_WINHTTP_CLIENT_AUTH_CERT_NEEDED. A struktúra kiállítói listája tartalmazza a kiszolgáló elfogadható hitelesítésszolgáltatóinak (CA) listáját. Az ügyfélalkalmazás szűrheti a hitelesítésszolgáltatói listát, hogy lekérje az SSL-hitelesítéshez szükséges ügyféltanúsítványt.

Ha a kiszolgáló kéri az ügyféltanúsítványt, de nincs rá szükség, az alkalmazás meghívhatja a WinHttpSetOptiont a WINHTTP_OPTION_CLIENT_CERT_CONTEXT lehetőséggel. További információ: WINHTTP_OPTION_CLIENT_CERT_CONTEXT lehetőség.

WINHTTP_OPTION_CODEPAGE

Beállítja az URL-cím feldolgozásához használt kódlapot (vagyis a lekérdezési sztringet). Az alapértelmezett érték az UTF8.

WINHTTP_OPTION_CONFIGURE_PASSPORT_AUTH

Egy aláíratlan hosszú egész számértéket állít be, amely meghatározza, hogy engedélyezve van-e a Passport-hitelesítés a WinHTTP-hitelesítésben . Az érték a következők egyike lehet:

Időszak	Leírás
WINHTTP_DISABLE_PASSPORT_AUTH	A Microsoft Passport-hitelesítés le van tiltva. Ez az alapértelmezett érték.
WINHTTP_DISABLE_PASSPORT_KEYRING	A Passport billentyűkombináció le van tiltva. Ez az alapértelmezett érték.
WINHTTP_ENABLE_PASSPORT_AUTH	A passport-hitelesítés engedélyezve van.
WINHTTP_ENABLE_PASSPORT_KEYRING	A Passport billentyűkombináció engedélyezve van.

WINHTTP_OPTION_CONNECT_RETRIES

Beállít vagy lekér egy aláíratlan hosszú egész számot, amely azt tartalmazza, hogy aWinHTTP hány alkalommal kísérel meg csatlakozni egy gazdagéphez. A Microsoft Windows HTTP Services (WinHTTP) ip-címenként csak egyszer próbálkozik. Ha például egy 10 IP-címmel rendelkező és WINHTTP_OPTION_CONNECT_RETRIES WINHTTP_OPTION_CONNECT_RETRIES többhelyes gazdagéphez próbál csatlakozni, akkor a WinHTTP csak az első hét IP-címhez próbál csatlakozni. Ha a WINHTTP_OPTION_CONNECT_RETRIES 20-ra van állítva, a WinHTTP csak egyszer próbálja meg a 10 ip-címet. Ha a csatlakozási kísérlet a megadott számú kísérlet után is meghiúsul, vagy ha a kapcsolódási időtúllépés korábban lejárt, a rendszer megszakítja a kérést. A WINHTTP_OPTION_CONNECT_RETRIES alapértelmezett értéke öt kísérlet.

WINHTTP_OPTION_CONNECT_TIMEOUT

Ezredmásodpercben beállít vagy lekér egy aláíratlan hosszú egész számot, amely az időtúllépési értéket tartalmazza. Ha ezt a beállítást végtelenre állítja (0xFFFFFFFF), az letiltja ezt az időzítőt.

Ha egy TCP-kapcsolatkérés ennél az időtúllépési értéknél hosszabb időt vesz igénybe, a kérés megszakad. Az alapértelmezett időtúllépés 60 másodperc. Ha egyetlen gazdagéphez (többhelyes gazdagéphez) több IP-címhez próbál csatlakozni, az időkorlát minden egyes kapcsolatra vonatkozik.

WINHTTP_OPTION_CONNECTION_INFO

Lekéri a WinHttpReceiveResponse visszatérésekor a választ generáló kérés forrás- és cél IP-címét és portját. Az alkalmazás meghívja a WinHttpQueryOptiont az WINHTTP_OPTION_CONNECTION_INFO beállítással, és biztosítja a WINHTTP_CONNECTION_INFO struktúrát az lpBuffer paraméterben. További információ: WINHTTP_CONNECTION_INFO.

A következőkre vonatkozik: Windows XP SP2-vel és újabb verzióval; Windows 2003 SP1 és újabb verzióval.

WINHTTP_OPTION_CONNECTION_GUID

Jelölje meg a WinHTTP kéréskezelőjéhez társított kapcsolatot GUID azonosítóval. Ez lehetővé teszi az egyéni vezérlést, hogy mely kérések használják a WINHTTP_OPTION_MATCH_CONNECTION_GUID beállítással rendelkező kapcsolatcsoportokat.

WINHTTP_OPTION_CONNECTION_STATS_V0

Újrapróbálkozza a kérés által használt mögöttes kapcsolat TCP_INFO_v0 szerkezetét. A visszaadott szerkezet tartalmazhat statisztikát az ugyanazon a kapcsolaton keresztül küldött korábbi kérésekből.

Megjegyzés:

Ezt a beállítást felváltotta WINHTTP_OPTION_CONNECTION_STATS_V1.

WINHTTP_OPTION_CONNECTION_STATS_V1

Újrapróbálkozza a kérés által használt mögöttes kapcsolat TCP_INFO_v1 szerkezetét. A visszaadott szerkezet tartalmazhat statisztikát az ugyanazon a kapcsolaton keresztül küldött korábbi kérésekből.

WINHTTP_OPTION_CONTEXT_VALUE

Beállít vagy lekér egy DWORD_PTR , amely a HINTERNET leíróhoz társított környezeti értékre mutató mutatót tartalmaz. A rendszer a pufferben tárolt értéket használja, és a WINHTTP_OPTION_CONTEXT_VALUE beállításjelző új értéket kap.

WINHTTP_OPTION_DECOMPRESSION

Beállít egy DWORD jelölőket, amelyek meghatározzák, hogy a WinHTTP automatikusan kibontja-e a választesteket tömörített tartalomkódolásokkal. A WinHTTP egy megfelelő Accept-Encoding fejlécet is beállít, amely felülírja a hívó által megadott adatokat. A támogatott értékek a következők:

Időszak	Leírás
WINHTTP_DECOMPRESSION_FLAG_GZIP	Tartalomkódolás felbontása: gzip-válaszok.
WINHTTP_DECOMPRESSION_FLAG_DEFLATE	Tartalomkódolás felbontása: a válaszok deflálása.
WINHTTP_DECOMPRESSION_FLAG_ALL	A támogatott tartalomkódolással kapcsolatos válaszok felbontása.

Alapértelmezés szerint a WinHTTP tömörített válaszokat küld a hívónak, nem módosítva.

WINHTTP_OPTION_DISABLE_CERT_CHAIN_BUILDING

Ha ezt a beállítást egy WinHttp-munkamenet-leírón állítja be, engedélyezheti vagy letilthatja, hogy a kiszolgáló tanúsítványlánca létrejön-e.

WINHTTP_OPTION_DISABLE_FEATURE

Egy aláíratlan hosszú egész számértéket állít be, amely meghatározza, hogy mely funkciók legyenek letiltva az alábbi jelölők közül egy vagy többkel. Vegye figyelembe, hogy ezt a funkciót csak a WinHttpSetOption szolgáltatásnak kell átadni a kérelemleírókon a WinHttpOpenRequest szolgáltatással való létrehozása után, valamint a WinHttpSendRequest szolgáltatással való küldés előtt.

Időszak	Leírás
WINHTTP_DISABLE_AUTHENTICATION	Az automatikus hitelesítés le van tiltva.
WINHTTP_DISABLE_COOKIES	A cookie-fejlécek kérésekhez való automatikus hozzáadása le van tiltva. Emellett a visszaadott cookie-k nem lesznek automatikusan hozzáadva a cookie-adatbázishoz. A cookie-k letiltása a Passport-hitelesítés gyenge teljesítményét eredményezheti.
WINHTTP_DISABLE_KEEP_ALIVE	Letiltja az életben tartás szemantikáját a kapcsolathoz. Az MSN, az NTLM és más típusú hitelesítésekhez életben tartási szemantika szükséges.
WINHTTP_DISABLE_REDIRECTS	Az automatikus átirányítás le van tiltva a WinHttpSendRequest használatával küldött kérések esetén. Ha az automatikus átirányítás le van tiltva, az alkalmazásnak regisztrálnia kell egy visszahívási függvényt ahhoz, hogy a Passport-hitelesítés sikeres legyen.

WINHTTP_OPTION_DISABLE_GLOBAL_POOLING

Letiltja a globális, munkamenetek közötti készletezést. Ez azért ajánlott, mert a globális, munkamenetek közötti készletezés örökölt viselkedés, amely kompatibilitási okokból alapértelmezés szerint támogatott. Erre hatással van a maximális kapcsolatok manuális beállítása.

WINHTTP_OPTION_DISABLE_PROXY_AUTH_SCHEMES

Letilt egy vagy több alábbi proxyhitelesítési eljárást a WinHTTP-munkamenetben az OR összes alkalmazható lehetőség megadásával. Ezek mind olyan sémák, kivéve a WINHTTP_PROXY_DISABLE_AUTH_LOCAL_SERVICE, amelyek a helyi számítógépfiók használatát kényszerítik a kérések visszacsatolásra vagy helyi címre való küldésekor. Ez megakadályozza a rendszer hitelesítő adatainak helyi HTTP-proxykba való kiszivárgását.

Időszak	Leírás
WINHTTP_PROXY_DISABLE_SCHEME_BASIC	Letiltja az alapszintű hitelesítési sémát.
WINHTTP_PROXY_DISABLE_SCHEME_DIGEST	Letiltja a Kivonatoló hitelesítési sémát.
WINHTTP_PROXY_DISABLE_SCHEME_NTLM	Letiltja az NTLM hitelesítési sémát.
WINHTTP_PROXY_DISABLE_SCHEME_KERBEROS	Letiltja a Kerberos hitelesítési sémát.
WINHTTP_PROXY_DISABLE_SCHEME_NEGOTIATE	Letiltja az Egyeztetés hitelesítési sémát.
WINHTTP_PROXY_DISABLE_AUTH_LOCAL_SERVICE	A helyi számítógépfiók használatának kényszerítése a kérések visszacsatolásra vagy helyi címre való küldésekor.

WINHTTP_OPTION_DISABLE_SECURE_PROTOCOL_FALLBACK

Megakadályozza, hogy a WinHTTP újrapróbálkozza a kapcsolatot a biztonsági protokoll alacsonyabb verziójával, ha a kezdeti protokollal való egyeztetés meghiúsul.

WINHTTP_OPTION_DISABLE_STREAM_QUEUE

Lehetővé teszi, hogy az új kérések egy további HTTP/2-kapcsolatot nyissanak meg, amikor elérik az egyidejű stream maximális korlátját, ahelyett, hogy egy meglévő kapcsolat következő elérhető streamére várnak.

WINHTTP_OPTION_ENABLE_FEATURE

Egy aláíratlan hosszú egész számértéket állít be, amely meghatározza az aktuálisan engedélyezett funkciókat. Az alábbi értékek egyike lehet.

Időszak	Leírás
WINHTTP_ENABLE_SSL_REVERT_IMPERSONATION	Ha engedélyezve van, a WinHTTP ideiglenesen visszaállítja az ügyfelek megszemélyesítését az SSL-tanúsítványhitelesítési műveletek időtartamára. Ez az érték csak a munkamenet-leírón állítható be.
WINHTTP_ENABLE_SSL_REVOCATION	Ha engedélyezve van, a WinHTTP engedélyezi az SSL-visszavonást. Ez az érték csak a kérelemleírón állítható be.

WINHTTP_OPTION_ENABLE_HTTP_PROTOCOL

Az elfogadható fejlett HTTP-verziók DWORD bitmaszkját állítja be. A lehetséges értékek a következők:

Időszak	Leírás
WINHTTP_PROTOCOL_FLAG_HTTP2 (0x1)	Engedélyezi a HTTP/2-t a kéréshez.
WINHTTP_PROTOCOL_FLAG_HTTP3 (0x2)	Engedélyezi a HTTP/3-at a kéréshez.
Nincs (0x0)	A kérést HTTP/1.1-re és korábbira korlátozza.

Ezzel a beállítással a HTTP régebbi (1.1 és korábbi) verziói nem tilthatók le. Az alapértelmezett érték a 0x0.

WINHTTP_OPTION_ENABLE_HTTP2_PLUS_CLIENT_CERT

Ez a beállítás egy WinHttp munkamenet-leírón beállítható, hogy a WinHttp a hívó által megadott ügyféltanúsítvány-környezetet használja HTTP/2 használatakor.

WINHTTP_OPTION_ENABLETRACING

Beállít egy BOOL-értéket , amely meghatározza, hogy a nyomkövetés jelenleg engedélyezve van-e. Ez a beállítás csak NULLHINTERNET-leírón állítható be. Lásd még a WinHTTP-nyomkövetések gyűjtését.

WINHTTP_OPTION_ENCODE_EXTRA

Engedélyezi az URL-százalék kódolását az elérési úthoz és a lekérdezési sztringhez.

Azt is megteheti, hogy a WinHttp hívása előtt százalékban kódol.

WINHTTP_OPTION_EXPIRE_CONNECTION

Ez a beállítás csak olyan kérelemleírón állítható be, amely továbbra is aktív (küldés vagy fogadás). Ha ezt a beállítást választja, a WinHttp leállítja a kérések kézbesítését a megadott kérelemleíróval társított kapcsolaton. A kapcsolat akkor lesz lezárva, ha a kéréskezelő ezt a lehetőséget meghívja. Ez a beállítás nem fogad el paramétereket.

WINHTTP_OPTION_EXTENDED_ERROR

Lekéri az aláíratlan hosszú egész számot, amely egy Microsoft Windows Sockets hibakódot tartalmaz, amely megfeleltetett a ERROR_WINHTTP_* hibaüzeneteknek, amelyeket legutóbb ebben a szálkörnyezetben adott vissza. A leíró értékeként a NULL értéket is átadhatja.

WINHTTP_OPTION_FEATURE_SUPPORTED

Ellenőrizze, hogy a WinHTTP ezen verziója támogatja-e a megadott beállításjelzőt.

WINHTTP_OPTION_FIRST_AVAILABLE_CONNECTION

Alapértelmezés szerint, amikor a WinHttp kérést küld, ha nincs elérhető kapcsolat a kérés kiszolgálásához, a WinHttp megkísérli létrehozni az új kapcsolatot, és a kérés ehhez az új kapcsolathoz lesz kötve. Ha ezt a beállítást választja, az ilyen kérések az első elérhető kapcsolaton lesznek kézbesítve, és nem feltétlenül a létrehozott kapcsolaton.

WINHTTP_OPTION_GLOBAL_PROXY_CREDS

Egy WINHTTP_CREDS_EX szerkezetre mutató mutató, amelynek hInternet függvényparamétere NULL értékre van állítva. Ehhez a beállításhoz A HKLM\Software\Microsoft\Windows\CurrentVersion\Internet Settings! ShareCredsWithWinHttp. Ha ez a beállításkulcs nincs beállítva, a WinHTTP hibát ad vissza ERROR_WINHTTP_INVALID_OPTION. Ez a beállításkulcs alapértelmezés szerint nincs jelen. Ha be van állítva, a WinINet elküldi a hitelesítő adatokat a WinHTTP-nak. Amikor a WinHttp hitelesítési kihívást kap, és az aktuális leírón nincsenek megadva hitelesítő adatok, a WinINet által megadott hitelesítő adatokat fogja használni. Ahhoz, hogy a kiszolgáló hitelesítő adatait a proxy hitelesítő adatai mellett meg lehessen osztani, a felhasználóknak be kell állítaniuk WINHTTP_OPTION_USE_GLOBAL_SERVER_CREDENTIALS .

WINHTTP_OPTION_GLOBAL_SERVER_CREDS

Egy WINHTTP_CREDS_EX szerkezetre mutató mutató, amelynek hInternet függvényparamétere NULL értékre van állítva. Ehhez a beállításhoz A HKLM\Software\Microsoft\Windows\CurrentVersion\Internet Settings! ShareCredsWithWinHttp. Ha ez a beállításkulcs nincs beállítva, a WinHTTP hibát ad vissza ERROR_WINHTTP_INVALID_OPTION. Ez a beállításkulcs alapértelmezés szerint nincs jelen. Ha be van állítva, a WinINet elküldi a hitelesítő adatokat a WinHTTP-nak. Amikor a WinHttp hitelesítési kihívást kap, és az aktuális leírón nincsenek megadva hitelesítő adatok, a WinINet által megadott hitelesítő adatokat fogja használni. Ahhoz, hogy a kiszolgáló hitelesítő adatait a proxy hitelesítő adatai mellett meg lehessen osztani, a felhasználóknak be kell állítaniuk WINHTTP_OPTION_USE_GLOBAL_SERVER_CREDENTIALS .

WINHTTP_OPTION_HANDLE_TYPE

Lekéri az alá nem írt hosszú egész számot, amely tartalmazza az átadott HINTERNET-leíró típusát. A visszatérési érték a következők egyike lehet:

Időszak	Leírás
WINHTTP_HANDLE_TYPE_CONNECT	A fogópont egy kapcsolati fogópont.
WINHTTP_HANDLE_TYPE_REQUEST	A leíró egy kérelemleíró.
WINHTTP_HANDLE_TYPE_SESSION	A leíró egy munkamenet-leíró.

WINHTTP_OPTION_HTTP_PROTOCOL_REQUIRED

Megakadályozza, hogy a WINHTTP_OPTION_ENABLE_HTTP_PROTOCOL által engedélyezett protokollverzióktól eltérő protokollverziók legyenek használatban a kéréshez.

WINHTTP_OPTION_HTTP_PROTOCOL_USED

Lekéri a DWORD-t, amely jelzi, hogy melyik speciális HTTP-verziót használták egy adott kéréshez. A lehetséges értékek listájáért lásd: WINHTTP_OPTION_ENABLE_HTTP_PROTOCOL.

WINHTTP_OPTION_HTTP_VERSION

Beállít vagy lekér egy HTTP_VERSION_INFO struktúrát, amely deklarálja a támogatott örökölt HTTP-verziót. Ez egy folyamatszintű lehetőség; használja a NULL értéket a leíróhoz.

Megjegyzés:

Ez a struktúra HTTP/1.0 és HTTP/1.1 esetén érvényes. A modern HTTP-verziókért lásd WINHTTP_OPTION_ENABLE_HTTP_PROTOCOL és WINHTTP_OPTION_HTTP_PROTOCOL_USED.

WINHTTP_OPTION_HTTP2_KEEPALIVE

Ez a beállítás egy munkamenet-leírón beállítható úgy, hogy a WinHttp http/2 PING-kereteket használjon megőrzési mechanizmusként. A hívók ezredmásodpercben határoznak meg időtúllépést, és miután az adott időtúllépési időszakra vonatkozóan nincs tevékenység a kapcsolaton, a WinHttp elkezd HTTP/2 PING-kereteket küldeni. A hívók nem állíthatnak be 5000 ezredmásodpercnél kisebb időtúllépési értéket.

WINHTTP_OPTION_HTTP2_PLUS_TRANSFER_ENCODING

Ez a beállítás egy WinHttp-kérelemleírón beállítható annak szabályozására, hogy a WinHttp hogyan viselkedik, ha egy HTTP/2-válasz tartalmaz egy "Transfer-Encoding" fejlécet. Ilyen esetben a WinHttp hibát ad vissza, ha ez a beállítás HAMIS értékre van állítva.

WINHTTP_OPTION_HTTP2_RECEIVE_WINDOW

Állítsa be a kezdeti HTTP/2 stream fogadási ablakméretét és az ablakfrissítések küldésének küszöbértékét a WINHTTP_HTTP2_RECEIVE_WINDOW szerkezettel.

WINHTTP_OPTION_HTTP3_HANDSHAKE_TIMEOUT

A puffer használatával beállítja a HTTP/3 kézfogás időtúllépését ezredmásodpercben PDWORD-ként.

WINHTTP_OPTION_HTTP3_INITIAL_RTT

Ezredmásodpercben konfigurálja a kezdeti RTT-t, amelyet az msquic használ.

WINHTTP_OPTION_HTTP3_KEEPALIVE

Lehetővé teszi az életben tartás szemantikáját a kapcsolathoz. A puffer használatával beállítja az életben maradási időtúllépést ezredmásodpercben PDWORD-ként.

WINHTTP_OPTION_HTTP3_STREAM_ERROR_CODE

Lekéri a kiszolgáló által megadott hibát a kérés küldéséhez használt HTTP/3-adatfolyamon.

WINHTTP_OPTION_IGNORE_CERT_REVOCATION_OFFLINE

Lehetővé teszi, hogy a biztonságos kapcsolatok olyan biztonsági tanúsítványokat használjanak, amelyekhez a visszavont tanúsítványok listája nem tölthető le.

WINHTTP_OPTION_IPV6_FAST_FALLBACK

Lehetővé teszi az IPv6 gyors tartalék (Boldogabb Szemgolyók) használatát a kapcsolathoz. Ez a viselkedés hasonló az RFC 6555-ben leírt Happy Eyeballs viselkedéshez, amely javítja a kapcsolati időket azon hálózatokon, ahol az IPv6 megbízhatatlan.

• Ha az IPv6 és az IPv4-címek is feloldva vannak egy adott gazdagéphez, a WinHttp az első feloldott IPv6-címhez való csatlakozással kezdődik, rövid (300 ms) időtúllépéssel.
• Ha a kapcsolat meghiúsul, a WinHttp megpróbál csatlakozni az első feloldott IPv4-címhez a szokásos időtúllépéssel.
• Ha a második kapcsolat meghiúsul, a WinHttp újrapróbálkozza az első feloldott IPv6-címet a szokásos időtúllépéssel.
• Ha a harmadik kapcsolat meghiúsul, a WinHttp visszaáll az alapértelmezett viselkedésre a fennmaradó címek esetében, és megpróbál kapcsolatot létesíteni egymással a normál időtúllépéssel, amíg létre nem jön a kapcsolat, vagy nem maradnak címek.

WINHTTP_OPTION_IS_PROXY_CONNECT_RESPONSE

Lekérdezi, hogy lekérhető-e proxyvisszahívási válasz.

WINHTTP_OPTION_MATCH_CONNECTION_GUID

Egy WINHTTP_MATCH_CONNECTION_GUID utasítással utasítja a WinHTTP-t, hogy a kérést egyező kapcsolaton szolgálja ki. Ha WINHTTP_MATCH_CONNECTION_GUID_FLAG_REQUIRED van beállítva, akkor csak egyező GUID azonosítóval rendelkező kapcsolatok használhatók. Ellenkező esetben a guid azonosítóval nem megjelölt, egyező GRAFIKUS GUID-kkel és kapcsolatokkal rendelkező kapcsolatok használhatók.

WINHTTP_OPTION_MAX_CONNS_PER_1_0_SERVER

Beállít vagy lekér egy aláíratlan hosszú egész számot, amely a HTTP/1.0-kiszolgálónként engedélyezett kapcsolatok maximális számát tartalmazza. Az alapértelmezett érték az INFINITE.

A következőkre vonatkozik: Windows Vista SP1 és újabb verzióval; Windows Server 2008 és újabb verziók.

WINHTTP_OPTION_MAX_CONNS_PER_SERVER

Beállít vagy lekér egy aláíratlan hosszú egész számot, amely a kiszolgálónként engedélyezett kapcsolatok maximális számát tartalmazza. Az alapértelmezett érték az INFINITE.

Ha ez a beállítás nullára van állítva, a WinHTTP a kapcsolatok számának korlátját 2 értékre állítja.

WINHTTP_OPTION_MAX_HTTP_AUTOMATIC_REDIRECTS

Beállítja a WinHTTP által követett átirányítások maximális számát; az alapértelmezett érték 10. Ez a korlát megakadályozza, hogy a jogosulatlan webhelyek nagyszámú átirányítást követően szüneteltesse a WinHTTP-ügyfelet.

A következőkre vonatkozik: Windows XP SP1 és újabb verzióval; Windows 2000 SP3 és újabb verzióval.

WINHTTP_OPTION_MAX_HTTP_STATUS_CONTINUE

Az információs 100–199-es állapotkódra adott válaszok maximális száma, amely figyelmen kívül hagyva, mielőtt visszaadja a végső állapotkódot a WinHTTP-ügyfélnek. A 100-199-re vonatkozó tájékoztató állapotkódokat a kiszolgáló a végleges állapotkód előtt küldheti el, és a HTTP/1.1 specifikációja ismerteti (további információ: RFC 2616). Az alapértelmezett érték 10.

A következőkre vonatkozik: Windows XP SP1 és újabb verzióval; Windows 2000 SP3 és újabb verzióval.

WINHTTP_OPTION_MAX_RESPONSE_DRAIN_SIZE

A válaszokból kifolyt adatok mennyiségének kötése egy bájtban megadott kapcsolat újbóli felhasználásához. Az alapértelmezett érték 1 MB.

A következőkre vonatkozik: Windows XP SP1 és újabb verzióval; Windows 2000 SP3 és újabb verzióval.

WINHTTP_OPTION_MAX_RESPONSE_HEADER_SIZE

A kiszolgáló válaszának fejlécrészének maximális méretére vonatkozó kötött készlet bájtban megadva. Ez a kötés megvédi az ügyfelet egy jogosulatlan kiszolgálótól, amely végtelen mennyiségű fejlécadattal rendelkező válasz küldésével próbálja meg elakadni az ügyfelet. Az alapértelmezett érték 64 KB.

A következőkre vonatkozik: Windows XP SP1 és újabb verzióval; Windows 2000 SP3 és újabb verzióval.

WINHTTP_OPTION_PARENT_HANDLE

Ehhez a fogóponthoz kéri le a szülőfogópontot.

WINHTTP_OPTION_PASSPORT_COBRANDING_TEXT

Egy sztringet kér le, amely a Passport bejelentkezési kiszolgáló által biztosított együttes szöveggel rendelkezik. Ezt a beállítást azonnal le kell kérni, miután a bejelentkezési kiszolgáló egy 401-ben megadott állapotkóddal válaszol. Az alkalmazásnak bájtban megadott pufferméretet kell megadnia, amely elég nagy a visszaadott sztring tárolásához.

WINHTTP_OPTION_PASSPORT_COBRANDING_URL

Lekéri azt a sztringet, amely a Passport bejelentkezési kiszolgáló által biztosított társbranding ábra URL-címét tartalmazza. Ezt a beállítást azonnal le kell kérni, miután a bejelentkezési kiszolgáló egy 401-ben megadott állapotkóddal válaszol. Az alkalmazásnak bájtban megadott pufferméretet kell megadnia, amely elég nagy a visszaadott sztring tárolásához.

WINHTTP_OPTION_PASSPORT_RETURN_URL

Beállít egy írásvédett beállítást egy kérelemleírón, amely lekéri a Passport visszatérési URL-címét.

WINHTTP_OPTION_PASSPORT_SIGN_OUT

Beállítja a munkamenet-leírók azon beállítását, hogy kijelentkeztethesse a Passport-bejelentkezéseket. Az alkalmazásnak meg kell adnia a Passport visszatérési URL-címét, amelyet WINHTTP_OPTION_PASSPORT_RETURN_URL kapott. A visszaküldött URL-címhez kapcsolódó összes cookie törlődik.

WINHTTP_OPTION_PASSWORD

Beállít vagy lekér egy sztringértéket, amely a kérelemleíróhoz társított jelszót tartalmazza.

WINHTTP_OPTION_PROXY

Beállít vagy lekér egy WINHTTP_PROXY_INFO struktúrát, amely egy meglévő munkamenet-leírón vagy kérelemleírón tartalmazza a proxyadatokat. Proxyadatok lekérésekor az alkalmazásnak felszabadítania kell az ebben a struktúrában található lpszProxy és lpszProxyBypass sztringeket (ha azok nem NULL értékűek) a GlobalFree függvény használatával. Az alkalmazások egy NULL leíróval lekérdezhetik a globális proxyadatokat (az alapértelmezett proxyt).

WINHTTP_OPTION_PROXY_PASSWORD

Beállít vagy lekér egy sztringértéket, amely tartalmazza a proxy eléréséhez használt jelszót.

WINHTTP_OPTION_PROXY_SPN_USED

Lekéri a WinHTTP által az SSPI-nek a hitelesítés során megadott proxykiszolgáló egyszerű nevét. Ez a sztringérték az SspiPromptForCredentials szolgáltatásnak való átadáshoz használható hitelesítési hiba után.

WINHTTP_OPTION_PROXY_USERNAME

Beállít vagy lekér egy sztringértéket, amely tartalmazza a proxy eléréséhez használt felhasználónevet.

WINHTTP_OPTION_QUIC_STATS

Olyan QUIC_STATISTICS struktúrát kér le, amely olyan kapcsolati információkat tartalmaz, mint az RTT és az elküldött és fogadott bájtok.

WINHTTP_OPTION_READ_BUFFER_SIZE

Ez a beállítás elavult; nincs hatása.

WINHTTP_OPTION_RECEIVE_PROXY_CONNECT_RESPONSE

Beállítja, hogy a proxyválasz-entitás lekérhető-e. Ez a beállítás alapértelmezés szerint le van tiltva.

WINHTTP_OPTION_RECEIVE_RESPONSE_TIMEOUT

Beállít vagy lekér egy aláíratlan hosszú egész számot, amely az időtúllépési értéket tartalmazza ezredmásodpercben, hogy megvárja, amíg az összes válaszfejlécet megkapja egy kéréshez. Ha a WinHTTP nem kapja meg az összes fejlécet ebben az időtúllépési időszakban, a kérés megszakad. Az alapértelmezett időtúllépési érték 90 másodperc.

Ezt az időtúllépést csak akkor ellenőrzi a rendszer, ha az adatok a szoftvercsatornából érkeznek. Ennek eredményeképpen az időtúllépés lejártakor az ügyfélalkalmazás csak akkor kap értesítést, ha több adat érkezik a kiszolgálóról. Ha nem érkeznek adatok a kiszolgálóról, az időtúllépés lejárata és az ügyfélalkalmazás értesítése közötti késés akkora lehet, mint a WinHttpSetTimeouts függvény dwReceiveTimeout paraméterével beállított időtúllépési érték.

WINHTTP_OPTION_RECEIVE_TIMEOUT

Beállít vagy lekér egy nem aláírt hosszú egész számot, amely ezredmásodpercben tartalmazza az időtúllépési értéket, hogy részleges választ kapjon egy kérésre, vagy beolvassa az adatokat. Ha a válasz ennél az időtúllépési értéknél tovább tart, a kérés megszakad. Az alapértelmezett időtúllépési érték 30 másodperc.

WINHTTP_OPTION_REDIRECT_POLICY

Beállítja a WinHTTP viselkedését a 30-szoros HTTP-átirányítási állapotkód kezelésére vonatkozóan. Ez a beállítás egy munkameneten vagy kérelemleírón az alábbi értékek egyikére állítható be:

Időszak	Leírás
WINHTTP_OPTION_REDIRECT_POLICY_ALWAYS	A rendszer minden átirányítást automatikusan követ.
WINHTTP_OPTION_REDIRECT_POLICY_DISALLOW_HTTPS_TO_HTTP	A rendszer minden átirányítást követ, kivéve azokat, amelyek egy biztonságos (https) URL-címről egy nem biztonságos (http) URL-címre származnak. Ez az alapértelmezett beállítás.
WINHTTP_OPTION_REDIRECT_POLICY_NEVER	Az átirányítások soha nem lesznek követve. A 30-szoros állapot visszakerül az alkalmazásba.

WINHTTP_OPTION_REJECT_USERPWD_IN_URL

Elutasítja a felhasználónevet és jelszót tartalmazó URL-címeket. Ez a beállítás a felhasználónév:jelszó szemantikát tartalmazó URL-címeket is elutasítja, még akkor is, ha nincs megadva felhasználónév vagy jelszó. Például az "u:p@hostname", a "@hostnameu:@hostname" és a ":p@hostname" mind érvénytelenként lesz megjelölve. Ha érvénytelen URL-címet ad át a függvénynek, az ERROR_WINHTTP_INVALID_URL ad vissza. Ez a beállítás alapértelmezés szerint ki van kapcsolva.

WINHTTP_OPTION_REQUEST_ANNOTATION

Lehetővé teszi a megadott széljegyzetnév kérésjegyzetének lekérését és beállítását. Ez lehetővé teszi, hogy a hívó sztringet csatoljon a későbbi lekérési kérelemhez, hogy a hívó által hasznosnak talált egyéni logika alapján azonosítsa a kéréseket.

WINHTTP_OPTION_REQUEST_PRIORITY

Ez a beállítás elavult; nincs hatása.

WINHTTP_OPTION_REQUEST_STATS

Újrapróbálkozza a kérés statisztikáit. Az elérhető statisztikák listáját a WINHTTP_REQUEST_STATS című témakörben találja.

WINHTTP_OPTION_REQUEST_TIMES

Újrapróbálkozza a kérés időzítési adatait. A rendelkezésre álló időzítések listáját lásd: WINHTTP_REQUEST_TIMES.

WINHTTP_OPTION_REQUIRE_STREAM_END

Ez a beállítás arra utasítja a WinHttp-t, hogy hagyja figyelmen kívül a "Content-Length" válaszfejléceket, és folytassa a fogadást a streamen, amíg meg nem kapja a END_STREAM jelzőt.

WINHTTP_OPTION_RESOLUTION_HOSTNAME

Ez a beállítás a WinHttp kérelemleírón is beállítható az elküldése előtt. Ha be van állítva, a WinHttp a hívó által megadott sztringet fogja használni a DNS-feloldás állomásneveként.

WINHTTP_OPTION_RESOLVE_TIMEOUT

Beállít vagy lekér egy aláíratlan hosszú egész számot, amely ezredmásodpercben tartalmazza az időtúllépési értéket egy gazdagépnév feloldásához. Az alapértelmezett időtúllépési érték az INFINITE. Ha nem alapértelmezett érték van megadva, a névfeloldásonként egy szállétrehozás többletterhelést jelent.

WINHTTP_OPTION_REVERT_IMPERSONATION_SERVER_CERT

Visszaállítja a szál megszemélyesítését a kiszolgáló tanúsítványláncának létrehozásakor, és ehelyett kényszeríti a folyamatjogkivonat használatát.

WINHTTP_OPTION_SECURE_PROTOCOLS

Egy aláíratlan hosszú egész számértéket állít be, amely meghatározza, hogy mely biztonságos (HTTPS) protokollok elfogadhatók. Ennek a beállításnak az alapértelmezett értéke az operációs rendszer verziójától függően változik, és a telepített frissítések befolyásolhatják.

• Windows 11. Alapértelmezés szerint csak a TLS1.2 és a TLS1.3 van engedélyezve.
• Windows 10 és Windows 8.1. Alapértelmezés szerint csak az SSL3, a TLS1.0, a TLS1.1 és a TLS1.2 engedélyezett.
• Windows 8 és Windows 7. Alapértelmezés szerint csak az SSL3 és a TLS1 van engedélyezve.

Az érték az alábbi értékek egy vagy több kombinációjából is lehet.

Időszak	Leírás
WINHTTP_FLAG_SECURE_PROTOCOL_ALL	A Secure Sockets Layer (SSL) 2.0, SSL 3.0 és Transport Layer Security (TLS) 1.0 protokollok használhatók.
WINHTTP_FLAG_SECURE_PROTOCOL_SSL2	Az SSL 2.0 protokoll használható.
WINHTTP_FLAG_SECURE_PROTOCOL_SSL3	Az SSL 3.0 protokoll használható.
WINHTTP_FLAG_SECURE_PROTOCOL_TLS1	A TLS 1.0 protokoll használható.
WINHTTP_FLAG_SECURE_PROTOCOL_TLS1_1	A TLS 1.1 protokoll használható.
WINHTTP_FLAG_SECURE_PROTOCOL_TLS1_2	A TLS 1.2 protokoll használható.
WINHTTP_FLAG_SECURE_PROTOCOL_TLS1_3	A TLS 1.3 protokoll használható.

Ha engedélyeznie kell az újabb protokollok támogatását, de nem tudja újrafordíteni az alkalmazást a WINHTTP_OPTION_SECURE_PROTOCOLS megfelelő értékeinek használatához, akkor ehelyett hozzáadhatja a DefaultSecureProtocols beállításjegyzék-bejegyzést. Ez a beállításjegyzék-bejegyzés lehetővé teszi annak megadását, hogy mely biztonságos protokollokat kell használni, ha a WINHTTP_OPTION_SECURE_PROTOCOLS beállítás nincs beállítva.

Fontos

Az alábbi utasítások a beállításjegyzék módosítását foglalják magukban. A beállításjegyzék helytelen módosítása azonban komoly problémákat okozhat, Ezért ügyeljen arra, hogy gondosan kövesse ezeket az utasításokat. A hozzáadott védelem érdekében a módosítás előtt biztonsági másolatot készít a beállításjegyzékről. Ezután visszaállíthatja a beállításjegyzéket, ha probléma merül fel. A beállításjegyzék biztonsági mentésével és visszaállításával kapcsolatos további információkért lásd: A beállításjegyzék biztonsági mentése és visszaállítása a Windowsban.

Ha egy alkalmazás nem hívja meg a WinHttpSetOption(WINHTTP_OPTION_SECURE_PROTOCOLS) parancsot, a rendszer ellenőrzi a DefaultSecureProtocols beállításjegyzék-bejegyzést, és ha van ilyen, felülbírálja a meglévő operációs rendszer alapértelmezett értékét a DefaultSecureProtocols beállításjegyzék-bejegyzésben megadott protokollokkal. A WinHTTP által megadott protokollokat felülírhatják a Biztonságos csatorna (Schannel) konfigurációs beállításai, amelyek letilthatják a protokollokat.

A beállításjegyzék-bejegyzést a DefaultSecureProtocols következő elérési úton adhatja hozzá:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Internet Settings\WinHttp

X64-alapú számítógépeken is hozzá kell adnia DefaultSecureProtocols az Wow6432Node elérési utat:

HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\Windows\CurrentVersion\Internet Settings\WinHttp

A beállításjegyzék értéke egy DWORD bitkép. A használni kívánt érték a kívánt protokollnak megfelelő értékek hozzáadásával határozható meg.

DefaultSecureProtocols érték	Protokoll engedélyezve
0x00000008	Az SSL 2.0 engedélyezése alapértelmezés szerint
0x00000020	Az SSL 3.0 engedélyezése alapértelmezés szerint
0x00000080	A TLS 1.0 engedélyezése alapértelmezés szerint
0x00000200	A TLS 1.1 engedélyezése alapértelmezés szerint
0x00000800	A TLS 1.2 engedélyezése alapértelmezés szerint
0x00002000	A TLS 1.3 engedélyezése alapértelmezés szerint

Ha például felül szeretné bírálni a WINHTTP_OPTION_SECURE_PROTOCOLS alapértelmezett értékeit a TLS 1.1 és a TLS 1.2 megadásához. Ebben az esetben vegye fel a TLS 1.1 (0x00000200) és a TLS 1.2 (0x00000800) értékét, adja hozzá őket együtt számológépben (programozó módban), és az eredményként kapott beállításjegyzék-érték 0x00000A00.

WINHTTP_OPTION_SECURITY_CERTIFICATE_STRUCT

Lekéri egy SSL/TLS-kiszolgáló tanúsítványát a WINHTTP_CERTIFICATE_INFO struktúrába. Az alkalmazásnak fel kell szabadítania az lpszSubjectInfo és az lpszIssuerInfo tagokat a LocalFree használatával.

WINHTTP_OPTION_SECURITY_FLAGS

Beállít vagy lekér egy nem aláírt hosszú egész számot, amely egy leíró biztonsági jelzőit tartalmazza. A következő értékek kombinációja lehet:

Időszak	Leírás
SECURITY_FLAG_IGNORE_CERT_CN_INVALID	Érvénytelen köznapi név engedélyezése a tanúsítványban; vagyis az alkalmazás által megadott kiszolgálónév nem egyezik meg a tanúsítványban szereplő köznapi névvel. Ha ez a jelző be van állítva, az alkalmazás nem kap WINHTTP_CALLBACK_STATUS_FLAG_CERT_CN_INVALID visszahívást.
SECURITY_FLAG_IGNORE_CERT_DATE_INVALID	Érvénytelen tanúsítványdátumot, vagyis lejárt vagy még nem érvényes tanúsítványt engedélyez. Ha ez a jelző be van állítva, az alkalmazás nem kap WINHTTP_CALLBACK_STATUS_FLAG_CERT_DATE_INVALID visszahívást.
SECURITY_FLAG_IGNORE_UNKNOWN_CA	Érvénytelen hitelesítésszolgáltató engedélyezése. Ha ez a jelző be van állítva, az alkalmazás nem kap WINHTTP_CALLBACK_STATUS_FLAG_INVALID_CA visszahívást.
SECURITY_FLAG_IGNORE_CERT_WRONG_USAGE	Lehetővé teszi a kiszolgáló identitásának létrehozását nem kiszolgálói tanúsítvánnyal (például ügyféltanúsítvánnyal).
SECURITY_FLAG_IGNORE_WEAK_SIGNATURE	Lehetővé teszi a gyenge aláírás figyelmen kívül hagyásához. Ez a jelző az összesítő frissítésben érhető el a Windows 7-től és a Windows Server 2008 R2-től kezdve minden operációs rendszernél.
SECURITY_FLAG_SECURE	Biztonságos átvitelt használ. Ezt csak a WinHttpQueryOption hívása adja vissza.
SECURITY_FLAG_STRENGTH_MEDIUM	Közepes (56 bites) titkosítást használ. Ezt csak a WinHttpQueryOption hívása adja vissza.
SECURITY_FLAG_STRENGTH_STRONG	Erős (128 bites) titkosítást használ. Ezt csak a WinHttpQueryOption hívása adja vissza.
SECURITY_FLAG_STRENGTH_WEAK	Gyenge (40 bites) titkosítást használ. Ezt csak a WinHttpQueryOption hívása adja vissza.

WINHTTP_OPTION_SECURITY_INFO

Egy kérés SChannel-kapcsolatának és titkosítási adatainak újbóli megadása.

WINHTTP_OPTION_SECURITY_KEY_BITNESS

Lekéri az aláíratlan hosszú egész számot, amely a titkosítási kulcs titkosítási erősségét tartalmazza. A nagyobb szám erősebb titkosítást jelez.

WINHTTP_OPTION_SEND_TIMEOUT

Beállít vagy lekér egy aláíratlan hosszú egész számot, amely ezredmásodpercben tartalmazza az időtúllépési értéket egy kérés elküldéséhez vagy adatok írásához. Ha a kérés elküldése hosszabb időt vesz igénybe, a küldési művelet megszakad. Az alapértelmezett időtúllépés 30 másodperc.

WINHTTP_OPTION_SERVER_CBT

A csatornakötési jogkivonatot (CBT) meghatározó SecPkgContext_Bindings struktúrára mutató mutatót kap.

A csatornakötési jogkivonat egy biztonságos átviteli csatorna tulajdonsága, és egy hitelesítési csatorna biztonságos átviteli csatornához való kötésére szolgál. Ez a jogkivonat csak az SSL-kapcsolat létrejötte után szerezhető be ezzel a beállítással.

Megjegyzés:

Ha ezt a lehetőséget és az lpBuffernull értékét adja át a WinHttpQueryOptionnak, az ERROR_INSUFFICIENT_BUFFER és a puffer szükséges bájtméretét adja vissza az lpdwBufferLength paraméterben. Ez a visszaadott pufferméret-érték átadható a csatornakötési jogkivonat lekérdezésére irányuló későbbi hívásban. Ezekre a lépésekre WINHTTP_CALLBACK_STATUS_REQUEST akkor van szükség, ha módosítani szeretné a kérésfejléceket a csatornakötési jogkivonat alapján. Vegye figyelembe, hogy a Windows XP és a Vista nem támogatja a kérésfejlécek módosítását a visszahívás során.

WINHTTP_OPTION_SERVER_CERT_CHAIN_CONTEXT

Lekéri a kiszolgáló minősítési láncának környezetét. WINHTTP_OPTION_SERVER_CERT_CHAIN_CONTEXT átadható, hogy duplikált mutatót kapjon a CERT_CHAIN_CONTEXT egy kialkudott SSL-kapcsolat során kapott kiszolgálótanúsítvány-lánchoz. Az ügyfélnek meg kell hívnia a CertFreeCertificateContextet a visszaadott PCCERT_CONTEXT mutatón, amely a pufferbe van töltve.

WINHTTP_OPTION_SERVER_CERT_CONTEXT

Lekéri a kiszolgáló minősítési környezetét. WINHTTP_OPTION_SERVER_CERT_CONTEXT átadható, hogy duplikált mutatót kapjon a CERT-KÖRNYEZEThez egy egyeztetett SSL-kapcsolat során kapott kiszolgálótanúsítványhoz. Az ügyfélnek meg kell hívnia a CertFreeCertificateContextet a visszaadott PCCERT_CONTEXT mutatón, amely a pufferbe van töltve.

WINHTTP_OPTION_SERVER_SPN_USED

Lekéri az SSPI-nek a hitelesítés során az SSPI-nek adott WinHTTP kiszolgálónév nevét. Ez a sztringérték egy hitelesítési hiba után továbbítható az SspiPromptFor Hitelesítő adatoknak .

WINHTTP_OPTION_SPN

Tartalmazza vagy eltávolítja a kiszolgáló portszámát, ha az egyszerű szolgáltatásnév a Kerberoshoz vagy a Kerberos-hitelesítés egyeztetéséhez készült. Ez a jelző az alábbi értékek egyike:

Időszak	Leírás
WINHTTP_DISABLE_SPN_SERVER_PORT	Eltávolítja a kiszolgáló portszámát.
WINHTTP_ENABLE_SPN_SERVER_PORT	Tartalmazza a kiszolgáló portszámát.

WINHTTP_OPTION_STREAM_ERROR_CODE

Ez a beállítás lekérdezhető egy WinHttp kérelemleírón, és a HTTP-streamen kapott RST_STREAM keret által jelzett hibakódot adja vissza.

WINHTTP_OPTION_TCP_FAST_OPEN

Engedélyezi a TCP Fast Open használatát a kapcsolathoz.

WINHTTP_OPTION_TCP_KEEPALIVE

Ez a beállítás egy WinHttp-munkamenet-leírón állítható be, hogy engedélyezze a TCP életben tartását a mögöttes szoftvercsatornán. Egy tcp_keepalive szerkezetet vesz fel.

WINHTTP_OPTION_TLS_FALSE_START

Engedélyezi a TLS False Start használatát a kapcsolathoz.

WINHTTP_OPTION_TCP_PRIORITY_STATUS

A TCP-szoftvercsatorna-készlet javasolt prioritásának lekérdezése WINHTTP_OPTION_TCP_PRIORITY_HINT. További részletekért tekintse meg a SIO_SET_PRIORITY_HINT dokumentációját.

WINHTTP_OPTION_TLS_PROTOCOL_INSECURE_FALLBACK

Ez a beállítás egy WinHttp munkamenet-leírón állítható be annak szabályozásához, hogy engedélyezett-e a TLS 1.0-ra való visszalépés, ha újabb protokollverzióval kapcsolatos TLS-kézfogási hiba történt.

WINHTTP_OPTION_UNLOAD_NOTIFY_EVENT

Egy eseményt vesz fel, amely akkor lesz beállítva, amikor az utolsó visszahívás befejeződött egy adott munkamenethez. Ezt a jelölőt munkamenet-leírón kell használni. Az esemény csak azután zárható be, hogy a WinHTTP beállította.

WINHTTP_OPTION_UNSAFE_HEADER_PARSING

Ez a beállítás belső használatra van fenntartva, és nem hívható meg.

WINHTTP_OPTION_UPGRADE_TO_WEB_SOCKET

Utasítja a vermet, hogy indítsa el a WebSocket kézfogási folyamatát a WinHttpSendRequest használatával. Ez a beállítás nem vesz igénybe paramétereket.

WINHTTP_OPTION_URL

Egy letöltött erőforrás teljes URL-címét tartalmazó sztringértéket kér le. Ha az eredeti URL-cím tartalmazott további adatokat, például keresési sztringeket vagy horgonyokat, vagy ha a hívást átirányították, a visszaadott URL-cím eltér az eredetitől. Az alkalmazásnak egy bájtban méretezett pufferben kell áthaladnia, amely elég nagy ahhoz, hogy a visszaadott URL-címet széles karakterrel tárolja.

WINHTTP_OPTION_USE_GLOBAL_SERVER_CREDENTIALS

BoOL-t vesz igénybe, és csak munkamenet-leírót állíthat be. A beállítás megadása után csak a munkamenet-leíróból létrehozott fogópontokra propagálja. Ha IGAZ, ez a beállítás végső megoldásként a WinInetről leküldött globális kiszolgálói hitelesítő adatok használatát okozza. Ennek a beállításnak az alapértelmezett értéke HAMIS. Ehhez a beállításhoz A HKLM\Software\Microsoft\Windows\CurrentVersion\Internet Settings! ShareCredsWithWinHttp. Ez a beállításkulcs alapértelmezés szerint nincs jelen. Ha be van állítva, a WinINet elküldi a hitelesítő adatokat a WinHTTP-nak. Amikor a WinHttp hitelesítési kihívást kap, és az aktuális leírón nincsenek megadva hitelesítő adatok, a WinINet által megadott hitelesítő adatokat fogja használni.

WINHTTP_OPTION_USE_SESSION_SCH_CRED

Lehetővé teszi, hogy a munkamenet összes végpontja alapértelmezés szerint használjon egyetlen hitelesítő adatot a végpontonkénti alapértelmezett hitelesítő adatok helyett. Ez javíthatja a teljesítményt azáltal, hogy csökkenti a hitelesítő adatok kezelésével kapcsolatos többletterhelést. Vegye figyelembe, hogy ez az alapértelmezett hitelesítő adat nem lesz hatással az ügyféltanúsítvány explicit megadásakor.

WINHTTP_OPTION_USER_AGENT

Beállítja vagy lekéri a felhasználói ügynök sztringet a WinHttpOpen által megadott és a későbbi WinHttpSendRequest függvényekben használt leírókon, feltéve, hogy a WinHttpAddRequestHeaders vagy a WinHttpSendRequest által hozzáadott fejléc nem bírálja felül. A felhasználói ügynök lekérésekor az alkalmazásnak át kell adnia egy bájtban méretezett puffert, amely elég nagy ahhoz, hogy széles karakterrel tárolja a visszaadott URL-címet. A felhasználói ügynök beállításakor a puffer mérete a sztring hossza karakterekben és a NULL terminátorban.

WINHTTP_OPTION_USERNAME

Beállít vagy lekéri a felhasználónevet tartalmazó sztringet.

WINHTTP_OPTION_WEB_SOCKET_CLOSE_TIMEOUT

Ezredmásodpercben megadja, hogy a WinHttpWebSocketClose mennyi ideig várjon a szoros kézfogás befejezésére. Az alapértelmezett érték 10 másodperc.

WINHTTP_OPTION_WEB_SOCKET_KEEPALIVE_INTERVAL

Ezredmásodpercben beállítja az időközt, hogy egy életben maradó csomagot küldjön a kapcsolaton keresztül. Az alapértelmezett időköz 30000 (30 másodperc). A minimális időköz 15000 (15 másodperc). Ha a WinHttpSetOption 15000-nél alacsonyabb értéket állít be, az ERROR_INVALID_PARAMETER fog visszatérni.

Megjegyzés:

A WINHTTP_OPTION_WEB_SOCKET_KEEPALIVE_INTERVAL alapértelmezett értéke a HKLM:\SOFTWARE\Microsoft\WebSocket\KeepaliveInterval függvényből olvasható be. Ha nincs beállítva érték, a rendszer az alapértelmezett 30000 értéket használja. 15000 ezredmásodpercnél kisebb megtartási időköz nem lehetséges.

WINHTTP_OPTION_WEB_SOCKET_RECEIVE_BUFFER_SIZE

Beállít vagy lekér egy DWORD-t, amely meghatározza a WebSocket-kapcsolatokon használandó fogadópuffer méretét.

WINHTTP_OPTION_WEB_SOCKET_SEND_BUFFER_SIZE

Beállít vagy lekér egy DWORD-t, amely megadja a WebSocket-kapcsolatokon használandó küldési puffer méretét.

WINHTTP_OPTION_WORKER_THREAD_COUNT

Egy aláíratlan hosszú egész számértéket állít be, amely meghatározza, hogy a szálkészletnek hány feldolgozószálat kell használnia az aszinkron befejezésekhez. Ennek a beállításnak az alapértelmezett értéke nulla, ami azt határozza meg, hogy a feldolgozószálak száma megegyezik a rendszeren található CPU-k számával. Ez a beállítás csak NULLHINTERNET-leírón állítható be, mielőtt aszinkron művelet történt. Ez a beállítás csak egyszer állítható be.

A következőkre vonatkozik: Windows 7 és újabb; Windows Server 2008 R2 és újabb verziók.

WINHTTP_OPTION_WRITE_BUFFER_SIZE

Ez a beállítás elavult; nincs hatása.

Megjegyzések

Az alábbi táblázat felsorolja a beállításjelzőket, megadva, hogy mely kezelőkre reagálhatnak, lekérdezhetők és beállíthatók-e, és hogy milyen adattípust használnak. Az "X" azt jelzi, hogy a beállításjelző érvényes a függvényhez vagy a leíróhoz, míg a "-" azt határozza meg, hogy a beállításjelző érvénytelen.

Ha olyan Windows-verzióban próbál meg beállításjelzőt beállítani vagy lekérdezni, amely nem támogatott, ERROR_WINHTTP_INVALID_OPTION fog eredményezni.

Beállításjelző és adattípus	Munkamenet-leíró	Kérelemleíró	Lekérdezési lehetőség	Beállítás beállítása	A Windows minimális verziója
WINHTTP_OPTION_ASSURED_NON_BLOCKING_CALLBACKS BOOL	X	-	-	X	-
WINHTTP_OPTION_AUTOLOGON_POLICY DWORD	-	X	-	X	-
WINHTTP_OPTION_BACKGROUND_CONNECTIONS DWORD	X	-	-	X	Windows 10 21H1-es verzió
WINHTTP_OPTION_CALLBACK LPVOID	X	X	X	X	-
WINHTTP_OPTION_CLIENT_CERT_CONTEXT CERT_CONTEXT	-	X	-	X	Windows Vista
WINHTTP_OPTION_CLIENT_CERT_ISSUER_LIST SecPkgContext_IssuerListInfoEx	-	X	X	-	Windows Vista
WINHTTP_OPTION_CODEPAGE DWORD	X	-	-	X	-
WINHTTP_OPTION_CONFIGURE_PASSPORT_AUTH DWORD	X	-	-	X	-
WINHTTP_OPTION_CONNECT_RETRIES DWORD	X	X	X	X	-
WINHTTP_OPTION_CONNECT_TIMEOUT DWORD	X	X	X	X	-
WINHTTP_OPTION_CONNECTION_INFO WINHTTP_CONNECTION_INFO	-	X	X	-	-
WINHTTP_OPTION_CONNECTION_STATS_V0 TCP_INFO_v0	-	X	X	-	Windows 10 1903-es verzió
WINHTTP_OPTION_CONNECTION_STATS_V1 TCP_INFO_v1	-	X	X	-	Windows 10 2004-es verzió
WINHTTP_OPTION_CONTEXT_VALUE DWORD_PTR	X	X	X	X	-
WINHTTP_OPTION_DECOMPRESSION DWORD	X	X	-	X	Windows 8.1
WINHTTP_OPTION_DISABLE_CERT_CHAIN_BUILDING BOOL	X	-	-	X	Windows 10 21H1-es verzió
WINHTTP_OPTION_DISABLE_FEATURE DWORD	-	X	-	X	-
WINHTTP_OPTION_DISABLE_SECURE_PROTOCOL_FALLBACK BOOL	X	-	-	X	Windows 10 1903-es verzió
WINHTTP_OPTION_DISABLE_STREAM_QUEUE BOOL	X	X	-	X	Windows 10 1809-es verzió
WINHTTP_OPTION_ENABLE_FEATURE DWORD	*	*	-	X	-
WINHTTP_OPTION_ENABLE_HTTP_PROTOCOL DWORD	X	X	-	X	Windows 10, 1607-es verzió
WINHTTP_OPTION_ENABLE_HTTP2_PLUS_CLIENT_CERT_CONTEXT BOOL	X	-	-	X	Windows 10 21H1-es verzió
WINHTTP_OPTION_ENABLETRACING DWORD	-	-	X	X	-
WINHTTP_OPTION_ENCODE_EXTRA BOOL	X	X	-	X	Windows 10 1803-es verzió
WINHTTP_OPTION_EXPIRE_CONNECTION Nincs adat.	-	X	-	X	Windows 10 1903-es verzió
WINHTTP_OPTION_EXTENDED_ERROR DWORD	X	X	X	-	-
WINHTTP_OPTION_FIRST_AVAILABLE_CONNECTION BOOL	X	-	-	X	Windows 10 21H1-es verzió
WINHTTP_OPTION_GLOBAL_PROXY_CREDS WINHTTP_CREDS	X	X	-	X	-
WINHTTP_OPTION_GLOBAL_SERVER_CREDS WINHTTP_CREDS_EX	X	X	-	X	-
WINHTTP_OPTION_HANDLE_TYPE DWORD	X	X	X	-	-
WINHTTP_OPTION_HTTP_PROTOCOL_REQUIRED BOOL	X	X	-	X	Windows 10 1903-es verzió
WINHTTP_OPTION_HTTP_PROTOCOL_USED DWORD	-	X	X	-	Windows 10, 1607-es verzió
WINHTTP_OPTION_HTTP_VERSION HTTP_VERSION_INFO	X	X	X	X	-
WINHTTP_OPTION_HTTP2_KEEPALIVE DWORD	X	-	-	X	Windows 10 21H1-es verzió
WINHTTP_OPTION_HTTP2_PLUS_TRANSFER_ENCODING BOOL	X	X	-	X	Windows 10 21H1-es verzió
WINHTTP_OPTION_IGNORE_CERT_REVOCATION_OFFLINE BOOL	-	X	-	X	Windows 10 2004-es verzió
WINHTTP_OPTION_IPV6_FAST_FALLBACK BOOL	X	-	-	X	Windows 10 1903-es verzió
WINHTTP_OPTION_IS_PROXY_CONNECT_RESPONSE BOOL	X	X	X	-	-
WINHTTP_OPTION_MAX_CONNS_PER_1_0_SERVER DWORD	X	-	X	X	-
WINHTTP_OPTION_MAX_CONNS_PER_SERVER DWORD	X	-	X	X	-
WINHTTP_OPTION_MAX_HTTP_AUTOMATIC_REDIRECTS DWORD	X	X	X	X	-
WINHTTP_OPTION_MAX_HTTP_STATUS_CONTINUE DWORD	X	X	X	X	-
WINHTTP_OPTION_MAX_RESPONSE_DRAIN_SIZE DWORD	X	X	X	X	-
WINHTTP_OPTION_MAX_RESPONSE_HEADER_SIZE DWORD	X	X	X	X	-
WINHTTP_OPTION_PARENT_HANDLE HINTERNET	X	X	X	-	-
WINHTTP_OPTION_PASSPORT_COBRANDING_TEXT LPWSTR	-	X	X	-	-
WINHTTP_OPTION_PASSPORT_COBRANDING_URL LPWSTR	-	X	X	-	-
WINHTTP_OPTION_PASSPORT_RETURN_URL LPVOID	-	X	X	-	-
WINHTTP_OPTION_PASSPORT_SIGN_OUT LPVOID	X	-	-	X	-
WINHTTP_OPTION_PASSWORD LPWSTR	-	X	X	X	-
WINHTTP_OPTION_PROXY WINHTTP_PROXY_INFO	X	X	X	X	-
WINHTTP_OPTION_PROXY_PASSWORD LPWSTR	-	X	X	X	-
WINHTTP_OPTION_PROXY_SPN_USED LPWSTR	-	X	X	-	-
WINHTTP_OPTION_PROXY_USERNAME LPWSTR	-	X	X	X	-
WINHTTP_OPTION_READ_BUFFER_SIZE DWORD	-	X	X	X	-
WINHTTP_OPTION_RECEIVE_PROXY_CONNECT_RESPONSE BOOL	X	X	-	X	-
WINHTTP_OPTION_RECEIVE_RESPONSE_TIMEOUT DWORD	X	X	X	X	-
WINHTTP_OPTION_RECEIVE_TIMEOUT DWORD	X	X	X	X	-
WINHTTP_OPTION_REDIRECT_POLICY DWORD	X	X	X	X	-
WINHTTP_OPTION_REJECT_USERPWD_IN_URL BOOL	-	X	-	X	-
WINHTTP_OPTION_REQUEST_PRIORITY DWORD	-	X	X	X	-
WINHTTP_OPTION_REQUEST_STATS WINHTTP_REQUEST_STATS	-	X	X	-	Windows 10 1903-es verzió
WINHTTP_OPTION_REQUEST_TIMES WINHTTP_REQUEST_TIMES	-	X	X	-	Windows 10 1903-es verzió
WINHTTP_OPTION_REQUIRE_STREAM_END BOOL	X	X	-	X	Windows 10 21H1-es verzió
WINHTTP_OPTION_RESOLUTION_HOSTNAME LPWSTR	-	X	-	X	Windows 10 21H1-es verzió
WINHTTP_OPTION_RESOLVE_TIMEOUT DWORD	X	X	X	X	-
WINHTTP_OPTION_SECURE_PROTOCOLS DWORD	X	-	-	X	-
WINHTTP_OPTION_SECURITY_CERTIFICATE_STRUCT WINHTTP_CERTIFICATE_INFO	-	X	X	-	-
WINHTTP_OPTION_SECURITY_FLAGS DWORD	-	X	X	X	-
WINHTTP_OPTION_SECURITY_INFO WINHTTP_SECURITY_INFO	-	X	X	-	Windows 10 2004-es verzió
WINHTTP_OPTION_SECURITY_KEY_BITNESS DWORD	-	X	X	-	-
WINHTTP_OPTION_SEND_TIMEOUT DWORD	X	X	X	X	-
WINHTTP_OPTION_SERVER_CBT SecPkgContext_Bindings*	-	X	X	-	-
WINHTTP_OPTION_SERVER_CERT_CHAIN_CONTEXT CERT_CHAIN_CONTEXT	-	X	X	-	Windows 10 2004-es verzió
WINHTTP_OPTION_SERVER_CERT_CONTEXT CERT-KÖRNYEZET	-	X	X	-	-
WINHTTP_OPTION_SERVER_SPN_USED LPWSTR	-	X	X	-	-
WINHTTP_OPTION_SPN DWORD	-	X	-	X	-
WINHTTP_OPTION_STREAM_ERROR_CODE DWORD	-	X	X	-	Windows 10 21H1-es verzió
WINHTTP_OPTION_TCP_FAST_OPEN BOOL	X	-	-	X	Windows 10 2004-es verzió
WINHTTP_OPTION_TCP_KEEPALIVE tcp_keepalive	X	-	-	X	Windows 10 2004-es verzió
WINHTTP_OPTION_TLS_FALSE_START BOOL	X	-	-	X	Windows 10 2004-es verzió
WINHTTP_OPTION_TLS_PROTOCOL_INSECURE_FALLBACK BOOL	X	-	-	X	Windows 10 21H1-es verzió
WINHTTP_OPTION_UNLOAD_NOTIFY_EVENT HINTERNET	X	-	-	X	-
WINHTTP_OPTION_UNSAFE_HEADER_PARSING DWORD	-	X	-	X	-
WINHTTP_OPTION_UPGRADE_TO_WEB_SOCKET Nincs adat.	-	X	-	X	-
WINHTTP_OPTION_URL LPWSTR	-	X	X	-	-
WINHTTP_OPTION_USE_GLOBAL_SERVER_CREDENTIALS BOOL	X	X	-	X	-
WINHTTP_OPTION_USER_AGENT LPWSTR	X	-	X	X	-
WINHTTP_OPTION_USERNAME LPWSTR	-	X	X	X	-
WINHTTP_OPTION_WEB_SOCKET_CLOSE_TIMEOUT DWORD	-	-	X	X	-
WINHTTP_OPTION_WEB_SOCKET_KEEPALIVE_INTERVAL DWORD	-	-	X	X	-
WINHTTP_OPTION_WEB_SOCKET_RECEIVE_BUFFER_SIZE DWORD	X	X	X	X	Windows 8.1
WINHTTP_OPTION_WEB_SOCKET_SEND_BUFFER_SIZE DWORD	X	X	X	X	Windows 8.1
WINHTTP_OPTION_WORKER_THREAD_COUNT DWORD	-	-	-	X	-
WINHTTP_OPTION_WRITE_BUFFER_SIZE DWORD	-	X	X	X	-

Megjegyzés:

Windows XP és Windows 2000 esetén lásd Run-Time követelményeket.

Követelmények

Követelmény	Érték
Minimálisan támogatott ügyfél	Windows XP, Windows 2000 Professional SP3 rendszerrel [csak asztali alkalmazások]
Minimálisan támogatott kiszolgáló	Windows Server 2003, Windows 2000 Server SP3 [csak asztali alkalmazások]
Terjeszthető	WinHTTP 5.0 és Internet Explorer 5.01 vagy újabb Windows XP és Windows 2000 rendszeren.
Fejléc	Winhttp.h

Lásd még

• WinHTTP-verziók