Nieuw in Windows Server 2008 en Windows Vista

Vanaf Windows Server 2008 en Windows Vista is de WinHTTP-API uitgebreid met de volgende functies.

Uploaden van bestanden groter dan 4 GB.

WinHttpSendRequest kan slechts 4 GB aan gegevens verzenden vanwege beperkingen in de grootte van de parameter voor de totale lengte van DWORD. Als u toepassingen in staat wilt stellen meer dan 4 GB aan gegevens te verzenden, wordt de Content-Length-header toegevoegd aan het verzoek en worden gegevens gespecificeerd als een LARGE_INTEGER (2^64 bytes). Zie WinHttpSendRequestvoor meer informatie. Deze functie wordt niet ondersteund in het COM-object IWinHttpRequest.

Transfer-Encoding koptekst

Met de Transfer-Encoding-header kunnen toepassingen gesegmenteerde gegevens naar de server verzenden. Wanneer de Transfer-Encoding-header aanwezig is in de aanvraag, verzendt de toepassing de aanvraag met een entiteit lichaamslengte van nul in de oproep naar WinHttpSendRequest. De hoofdtekst van de entiteit wordt verzonden in volgende aanroepen naar WinHttpWriteData-. Deze functie wordt niet ondersteund in het COM-object IWinHttpRequest.

Lijst met certificaatverleners van SSL-client ophalen

De applicatie kan de uitgeverslijst van SSL-clientcertificaten ophalen wanneer WinHttpSendRequest mislukt met een ERROR_WINHTTP_CLIENT_AUTH_CERT_NEEDED. Met een nieuwe optie, WINHTTP_OPTION_CLIENT_CERT_ISSUER_LIST, kunnen toepassingen de lijst met certificaatverleners ophalen en de lijst filteren op het optimale certificaat. Zie voor meer informatie de onderwerpen Optievlaggen en Lijst ophalen van instanties voor SSL-clientverificatie. Deze functie wordt niet ondersteund in het COM-object IWinHttpRequest.

Optionele client-certificaten

Wanneer WinHttpSendRequest mislukt met een ERROR_WINHTTP_CLIENT_AUTH_CERT_NEEDED, is het ssl-clientcertificaat mogelijk niet vereist voor de server. De server kan mogelijk terugkeren naar een andere vorm van verificatie of toestaan dat de client doorgaat met anonieme toegang. De toepassing stelt de optie WINHTTP_OPTION_CLIENT_CERT_CONTEXT in en geeft een macro op die WinHttp gebruikt om te bepalen of het clientcertificaat vereist is. Zie Option-vlaggenvoor meer informatie. Deze functie wordt niet ondersteund in het COM-object IWinHttpRequest.

BRON- en doel-IP-adressen

Wanneer WinHttpReceiveResponse voltooid, kan de toepassing het bron- en doel-IP-adres en de poort ophalen van de aanvraag die het antwoord heeft gegenereerd. Er wordt een nieuwe structuur opgegeven voor het ontvangen van de bron- en doeladressen wanneer de optie WINHTTP_OPTION_CONNECTION_INFO is ingesteld. Zie Option-vlaggenvoor meer informatie. Deze functie wordt niet ondersteund in het COM-object IWinHttpRequest.

Aanvullende SSL-clientverificatiefouten

Aanvullende SSL-clientverificatiefouten bieden meer informatie over het SSL-clientcertificaat. ERROR_WINHTTP_CLIENT_CERT_NO_PRIVATE_KEY- en ERROR_WINHTTP_CERT_NO_ACCESS_PRIVATE_KEY- client-certificaatfouten zijn nieuw voor Windows Server 2008, en Windows Vista. De IWinHttpRequest COM-object retourneert deze fouten in een HRESULT.