WinHttpReceiveResponse-Funktion (winhttp.h)

Artikel
08/27/2023

Die WinHttpReceiveResponse-Funktion wartet auf den Empfang der Antwort auf eine http-Anforderung, die von WinHttpSendRequest initiiert wurde. Wenn WinHttpReceiveResponse erfolgreich abgeschlossen wurde, wurden die status Code- und Antwortheader empfangen und stehen der Anwendung zur Überprüfung mithilfe von WinHttpQueryHeaders zur Verfügung. Eine Anwendung muss WinHttpReceiveResponse aufrufen, bevor winHttpQueryDataAvailable und WinHttpReadData für den Zugriff auf den Antwortentitätstext (sofern vorhanden) verwendet werden kann.

Syntax

WINHTTPAPI BOOL WinHttpReceiveResponse(
  [in] HINTERNET hRequest,
  [in] LPVOID    lpReserved
);

Parameter

[in] hRequest

HINTERNET-Handle , das von WinHttpOpenRequest zurückgegeben und von WinHttpSendRequest gesendet wird. Warten Sie, bis WinHttpSendRequest für dieses Handle abgeschlossen ist, bevor Sie WinHttpReceiveResponse aufrufen.

[in] lpReserved

Dieser Parameter ist reserviert und muss NULL sein.

Rückgabewert

Gibt TRUE zurück, wenn erfolgreich, andernfalls FALSE . Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen zu erhalten. Zu den zurückgegebenen Fehlercodes gehören die folgenden.

Fehlercode	BESCHREIBUNG
ERROR_WINHTTP_CANNOT_CONNECT	Wird zurückgegeben, wenn die Verbindung mit dem Server fehlgeschlagen ist.
ERROR_WINHTTP_CHUNKED_ENCODING_HEADER_SIZE_OVERFLOW	Wird zurückgegeben, wenn während der Analyse der blockierten Codierung eine Überlaufbedingung auftritt.
ERROR_WINHTTP_CLIENT_AUTH_CERT_NEEDED	Wird zurückgegeben, wenn der Server die Clientauthentifizierung anfordert.
ERROR_WINHTTP_CONNECTION_ERROR	Die Verbindung mit dem Server wurde zurückgesetzt oder beendet, oder es wurde ein inkompatibles SSL-Protokoll gefunden. Beispielsweise unterstützt WinHTTP Version 5.1 SSL2 nur, wenn der Client dies ausdrücklich aktiviert.
ERROR_WINHTTP_HEADER_COUNT_EXCEEDED	Wird zurückgegeben, wenn eine größere Anzahl von Headern in einer Antwort vorhanden war, als WinHTTP empfangen konnte.
ERROR_WINHTTP_HEADER_SIZE_OVERFLOW	Wird von WinHttpReceiveResponse zurückgegeben, wenn die Größe der empfangenen Header den Grenzwert für das Anforderungshandle überschreitet.
ERROR_WINHTTP_INCORRECT_HANDLE_STATE	Der angeforderte Vorgang kann nicht ausgeführt werden, da sich das angegebene Handle nicht im richtigen Zustand befindet.
ERROR_WINHTTP_INCORRECT_HANDLE_TYPE	Der Typ des angegebenen Handles ist für diesen Vorgang falsch.
ERROR_WINHTTP_INTERNAL_ERROR	Ein interner Fehler ist aufgetreten.
ERROR_WINHTTP_INVALID_SERVER_RESPONSE	Die Serverantwort konnte nicht analysiert werden.
ERROR_WINHTTP_INVALID_URL	Die URL ist ungültig.
ERROR_WINHTTP_LOGIN_FAILURE	Fehler beim Anmeldeversuch. Wenn dieser Fehler auftritt, sollte das Anforderungshandle mit WinHttpCloseHandle geschlossen werden. Ein neues Anforderungshandle muss erstellt werden, bevor die Funktion wiederholt wird, die diesen Fehler ursprünglich verursacht hat.
ERROR_WINHTTP_NAME_NOT_RESOLVED	Der Servername konnte nicht aufgelöst werden.
ERROR_WINHTTP_OPERATION_CANCELLED	Der Vorgang wurde abgebrochen, in der Regel, weil das Handle, für das die Anforderung ausgeführt wurde, vor Abschluss des Vorgangs geschlossen wurde.
ERROR_WINHTTP_REDIRECT_FAILED	Die Umleitung ist fehlgeschlagen, weil sich entweder das Schema geändert hat oder alle Umleitungsversuche fehlgeschlagen sind (Standardwert sind fünf Versuche).
ERROR_WINHTTP_RESEND_REQUEST	Fehler bei der WinHTTP-Funktion. Die gewünschte Funktion kann mit dem gleichen Anforderungshandle wiederholt werden.
ERROR_WINHTTP_RESPONSE_DRAIN_OVERFLOW	Wird zurückgegeben, wenn eine eingehende Antwort ein internes WinHTTP-Größenlimit überschreitet.
ERROR_WINHTTP_SECURE_FAILURE	Mindestens ein Fehler wurde in dem SSL-Zertifikat (Secure Sockets Layer) gefunden, das vom Server gesendet wurde. Um zu ermitteln, welche Art von Fehler aufgetreten ist, suchen Sie in einer status Rückruffunktion nach einer WINHTTP_CALLBACK_STATUS_SECURE_FAILURE-Benachrichtigung. Weitere Informationen finden Sie unter WINHTTP_STATUS_CALLBACK.
ERROR_WINHTTP_TIMEOUT	Timeout für die Anforderung.
ERROR_WINHTTP_UNRECOGNIZED_SCHEME	Die URL hat ein anderes Schema als "http:" oder "https:" angegeben.
ERROR_NOT_ENOUGH_MEMORY	Es war nicht genügend Arbeitsspeicher verfügbar, um den angeforderten Vorgang abzuschließen. (Windows-Fehlercode)

Hinweise

Auch wenn WinHTTP im asynchronen Modus verwendet wird (d. h. wenn WINHTTP_FLAG_ASYNC in WinHttpOpen festgelegt wurde), kann diese Funktion entweder synchron oder asynchron ausgeführt werden. Wenn diese Funktion FALSE zurückgibt, ist bei dieser Funktion ein Fehler aufgetreten, und Sie können GetLastError aufrufen, um erweiterte Fehlerinformationen zu erhalten. Wenn diese Funktion TRUE zurückgibt, sollte die Anwendung entweder den WINHTTP_CALLBACK_STATUS_HEADERS_AVAILABLE Abschlussrückruf erwarten, der den Erfolg angibt, oder den WINHTTP_CALLBACK_STATUS_REQUEST_ERROR Abschlussrückruf, der angibt, dass der Vorgang asynchron abgeschlossen wurde, aber fehlgeschlagen ist.

Wenn eine status Rückruffunktion mit WinHttpSetStatusCallback installiert wurde, zeigen die Benachrichtigungen der folgenden Benachrichtigungen, die im dwNotificationFlags-Parameter von WinHttpSetStatusCallback festgelegt wurden, den Fortschritt beim Empfang der Antwort an:

WINHTTP_CALLBACK_STATUS_RECEIVING_RESPONSE
WINHTTP_CALLBACK_STATUS_RESPONSE_RECEIVED
WINHTTP_CALLBACK_STATUS_HEADERS_AVAILABLE
WINHTTP_CALLBACK_STATUS_INTERMEDIATE_RESPONSE
WINHTTP_CALLBACK_STATUS_REDIRECT

Wenn der Server die Verbindung schließt, werden auch die folgenden Benachrichtigungen gemeldet, sofern sie im dwNotificationFlags-Parameter von WinHttpSetStatusCallback festgelegt wurden:

WINHTTP_CALLBACK_STATUS_CLOSING_CONNECTION
WINHTTP_CALLBACK_STATUS_CONNECTION_CLOSED

Hinweis Informationen zu Windows XP und Windows 2000 finden Sie im Abschnitt Laufzeitanforderungen der WinHttp-Startseite .

Beispiele

Dieses Beispiel zeigt Code, der Daten auf einen HTTP-Server schreibt. Der im Beispiel angegebene Servername www.wingtiptoys.com ist fiktiv und muss durch den Namen eines Servers ersetzt werden, für den Sie Schreibzugriff haben.

    LPSTR pszData = "WinHttpWriteData Example";
    DWORD dwBytesWritten = 0;
    BOOL  bResults = FALSE;
    HINTERNET hSession = NULL,
              hConnect = NULL,
              hRequest = NULL;

    // Use WinHttpOpen to obtain a session handle.
    hSession = WinHttpOpen(  L"A WinHTTP Example Program/1.0", 
                             WINHTTP_ACCESS_TYPE_DEFAULT_PROXY,
                             WINHTTP_NO_PROXY_NAME, 
                             WINHTTP_NO_PROXY_BYPASS, 0);

    // Specify an HTTP server.
    if (hSession)
        hConnect = WinHttpConnect( hSession, L"www.wingtiptoys.com",
                                   INTERNET_DEFAULT_HTTP_PORT, 0);

    // Create an HTTP Request handle.
    if (hConnect)
        hRequest = WinHttpOpenRequest( hConnect, L"PUT", 
                                       L"/writetst.txt", 
                                       NULL, WINHTTP_NO_REFERER, 
                                       WINHTTP_DEFAULT_ACCEPT_TYPES, 
                                       0);

    // Send a Request.
    if (hRequest) 
        bResults = WinHttpSendRequest( hRequest, 
                                       WINHTTP_NO_ADDITIONAL_HEADERS,
                                       0, WINHTTP_NO_REQUEST_DATA, 0, 
                                       (DWORD)strlen(pszData), 0);

    // Write data to the server.
    if (bResults)
        bResults = WinHttpWriteData( hRequest, pszData, 
                                     (DWORD)strlen(pszData), 
                                     &dwBytesWritten);

    // End the request.
    if (bResults)
        bResults = WinHttpReceiveResponse( hRequest, NULL);

    // Report any errors.
    if (!bResults)
        printf("Error %d has occurred.\n",GetLastError());


    // Close any open handles.
    if (hRequest) WinHttpCloseHandle(hRequest);
    if (hConnect) WinHttpCloseHandle(hConnect);
    if (hSession) WinHttpCloseHandle(hSession);

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP, Windows 2000 Professional mit SP3 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003, Windows 2000 Server mit SP3 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winhttp.h
Bibliothek	Winhttp.lib
DLL	Winhttp.dll
Verteilbare Komponente	WinHTTP 5.0 und Internet Explorer 5.01 oder höher unter Windows XP und Windows 2000.