HttpSendRequestExA 関数 (wininet.h)

  • [アーティクル]

指定した要求を HTTP サーバーに送信します。

メモ 通常 HttpSendRequestEx に渡されるデータを超えて余分なデータを送信する必要がある呼び出し元は、代わりに HttpSendRequest を 呼び出すことによってこれを行うことができます。
 

構文

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

パラメーター

[in] hRequest

HttpOpenRequest 関数の呼び出しによって返されるハンドル。

[in] lpBuffersIn

省略可能。 INTERNET_BUFFERS構造体へのポインター。

[out] lpBuffersOut

予約済み。 NULL にする必要があります。

[in] dwFlags

予約済み。 ゼロを指定してください。

[in] dwContext

状態コールバック関数が登録されている場合は、アプリケーション定義のコンテキスト値。

戻り値

関数が成功した場合、関数は TRUE を返します。

関数が失敗すると、 FALSE が返されます。 詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

HttpSendRequestEx は 、応答の送信と受信の両方を実行します。 これにより、 アプリケーションは HttpSendRequestEx に渡された単一のバッファーを超える余分なデータを送信できません。 通常 HttpSendRequestEx に渡されるデータを超えて余分なデータを送信する必要がある呼び出し元は、代わりに HttpSendRequest を 呼び出すことによってこれを行うことができます。 HttpSendRequestEx を呼び出した後、InternetWriteFile を呼び出して残りのデータを送信します。 最後に、 HttpEndRequest の呼び出しをフォローアップします。

メモHttpSendRequestExA 関数は、ANSI 文字ではなく ISO-8859-1 文字として送信するデータを表します。 HttpSendRequestExW 関数は、UTF-16LE 文字に変換された ISO-8859-1 文字として送信するデータを表します。 その結果、追加するヘッダーに ASCII 以外の文字を含めることができる場合は、 HttpSendRequestExW 関数を使用しても安全ではありません。 代わりに、アプリケーションは MultiByteToWideChar 関数と WideCharToMultiByte 関数を使用し、 Codepage パラメーターを 28591 に設定して ANSI 文字と UTF-16LE 文字の間でマップできます。
 
メモ WinINet では、サーバーの実装はサポートされていません。 また、サービスから使用しないでください。 サーバーの実装またはサービスの場合は、 Microsoft Windows HTTP サービス (WinHTTP) を使用します。
 

注意

wininet.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして HttpSendRequestEx を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー wininet.h
Library Wininet.lib
[DLL] Wininet.dll

こちらもご覧ください

HTTP セッション

WinINet 関数