Foutafhandeling in WinHTTP

Niet alle WinHTTP API-functies rapporteren fouten op dezelfde manier.

Sommige functies, zoals WinHttpSetTimeouts, retourneren een BOOL- die een fout aangeeft wanneer FALSE. Als ONWAAR wordt geretourneerd, moeten bellers die geïnteresseerd zijn in de fout, GetLastErroraanroepen. Als GetLastError- wordt aangeroepen wanneer de functie wordt aangeroepen (geretourneerd alles behalve ONWAAR), is de geretourneerde waarde onvoorspelbaar en kan deze veranderen tussen Windows-versies, servicepacks of zelfs tussen aanroepen naar dezelfde functie.

Sommige functies, zoals WinHttpConnect, retourneren een ACHTERNET pseudohandgreep. Deze functies zijn precies hetzelfde, behalve dat de fout wordt aangegeven door NULL-te retourneren. Als NULL- wordt geretourneerd, moeten bellers die geïnteresseerd zijn in de fout, GetLastErroraanroepen. Als GetLastError- wordt aangeroepen wanneer de functie wordt aangeroepen (geretourneerd alles behalve NULL-), is de geretourneerde waarde onvoorspelbaar en kan deze veranderen tussen Windows-versies, servicepacks of zelfs tussen aanroepen naar dezelfde functie.

Sommige functies, zoals WinHttpGetProxyResult, retourneren een DWORD-foutcode en er is geen noodzaak om andere functies aan te roepen voor meer foutinformatie. Voor deze functies mag GetLastError- niet worden aangeroepen. Als GetLastError- wordt aangeroepen, ongeacht het slagen of mislukken van de functie, is de geretourneerde waarde onvoorspelbaar en kan deze veranderen tussen Windows-versies, servicepacks of zelfs tussen aanroepen naar dezelfde functie.