Fehlerbehandlung in WinHTTP

Nicht alle WinHTTP-API-Funktionen melden Fehler auf die gleiche Weise.

Einige Funktionen, z. B. WinHttpSetTimeouts-, geben eine BOOL- zurück, die einen Fehler angibt, wenn FALSE-. Wenn FALSE- zurückgegeben wird, sollten Anrufer, die an dem Fehler interessiert sind, GetLastError-aufrufen. Wenn GetLastError- aufgerufen wird, wenn die Funktion erfolgreich war (alles, was aber FALSEzurückgegeben wurde), ist der zurückgegebene Wert unvorhersehbar und kann zwischen Windows-Versionen, Service Packs oder sogar zwischen Aufrufen derselben Funktion geändert werden.

Einige Funktionen, z. B. WinHttpConnect, geben einen HINTERNET Pseudohandle zurück. Diese Funktionen sind identisch, es sei denn, fehler werden durch Zurückgeben NULL-angegeben. Wenn NULL- zurückgegeben wird, sollten anrufer, die an dem Fehler interessiert sind, GetLastErroraufrufen. Wenn GetLastError- aufgerufen wird, wenn die Funktion erfolgreich war (alles zurückgegeben, aber NULL), ist der zurückgegebene Wert unvorhersehbar und kann zwischen Windows-Versionen, Service Packs oder sogar zwischen Aufrufen derselben Funktion geändert werden.

Einige Funktionen, z. B. WinHttpGetProxyResult, geben einen DWORD- Fehlercode zurück und es ist nicht erforderlich, weitere Fehlerinformationen aufzurufen. Für diese Funktionen sollte GetLastError- nicht aufgerufen werden. Wenn GetLastError- aufgerufen wird, unabhängig vom Erfolg oder Fehler der Funktion, ist der zurückgegebene Wert unvorhersehbar und kann zwischen Windows-Versionen, Service Packs oder sogar zwischen Aufrufen derselben Funktion geändert werden.