HttpSendRequestExA-Funktion (wininet.h)

  • Artikel

Sendet die angegebene Anforderung an den HTTP-Server.

Hinweis Aufrufer, die zusätzliche Daten senden müssen, die über die normalerweise an HttpSendRequestEx übergebenen Daten hinausgehen, können dies stattdessen durch Aufrufen von HttpSendRequest tun.
 

Syntax

BOOL HttpSendRequestExA(
  [in]  HINTERNET           hRequest,
  [in]  LPINTERNET_BUFFERSA lpBuffersIn,
  [out] LPINTERNET_BUFFERSA lpBuffersOut,
  [in]  DWORD               dwFlags,
  [in]  DWORD_PTR           dwContext
);

Parameter

[in] hRequest

Ein Handle, das von einem Aufruf der HttpOpenRequest-Funktion zurückgegeben wird.

[in] lpBuffersIn

Optional. Ein Zeiger auf eine INTERNET_BUFFERS-Struktur .

[out] lpBuffersOut

Reserviert. Muss NULL sein.

[in] dwFlags

Reserviert. Muss Null sein.

[in] dwContext

Anwendungsdefinierter Kontextwert, wenn eine status Rückruffunktion registriert wurde.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion TRUE zurück.

Wenn die Funktion fehlschlägt, wird FALSE zurückgegeben. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

HttpSendRequestEx führt sowohl das Senden als auch den Empfang für die Antwort aus. Dadurch kann die Anwendung keine zusätzlichen Daten über den einzelnen Puffer senden, der an HttpSendRequestEx übergeben wurde. Aufrufer, die zusätzliche Daten senden müssen, die über die normalerweise an HttpSendRequestEx übergebenen Daten hinausgehen, können dies stattdessen durch Aufrufen von HttpSendRequest tun. Senden Sie nach dem Aufruf von HttpSendRequestEx die verbleibenden Daten, indem Sie InternetWriteFile aufrufen. Zum Schluss folgen Sie einem Aufruf von HttpEndRequest.

Hinweis Die HttpSendRequestExA-Funktion stellt Daten dar, die als ISO-8859-1-Zeichen und nicht als ANSI-Zeichen gesendet werden sollen. Die HttpSendRequestExW-Funktion stellt Daten dar, die als ISO-8859-1-Zeichen gesendet werden sollen, die in UTF-16LE-Zeichen konvertiert werden. Daher ist es nie sicher, die HttpSendRequestExW-Funktion zu verwenden, wenn die hinzuzufügenden Header Nicht-ASCII-Zeichen enthalten können. Stattdessen kann eine Anwendung die Funktionen MultiByteToWideChar und WideCharToMultiByte mit einem Codepage-Parameter verwenden, der auf 28591 festgelegt ist, um zwischen ANSI-Zeichen und UTF-16LE-Zeichen zuzuordnen.
 
Hinweis WinINet unterstützt keine Serverimplementierungen. Darüber hinaus sollte es nicht von einem Dienst verwendet werden. Verwenden Sie für Serverimplementierungen oder Dienste Microsoft Windows HTTP Services (WinHTTP).
 

Hinweis

Der wininet.h-Header definiert HttpSendRequestEx als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile wininet.h
Bibliothek Wininet.lib
DLL Wininet.dll

Weitere Informationen

HTTP-Sitzungen

WinINet-Funktionen