HttpSendRequestA 関数 (wininet.h)
指定した要求を HTTP サーバーに送信します。これにより、呼び出し元は通常 httpsendRequestExに通常渡されるデータを超えるデータ
構文
BOOL HttpSendRequestA(
[in] HINTERNET hRequest,
[in] LPCSTR lpszHeaders,
[in] DWORD dwHeadersLength,
[in] LPVOID lpOptional,
[in] DWORD dwOptionalLength
);
パラメーター
[in] hRequest
HttpOpenRequest 関数の呼び出しによって返されるハンドル。
[in] lpszHeaders
要求に追加する追加のヘッダーを含む、null終了文字列へのポインター。 追加する追加のヘッダーがない場合は、このパラメーターを NULL
[in] dwHeadersLength
追加ヘッダーのサイズ (TCHAR)。 このパラメーターが -1L で、lpszHeaders
[in] lpOptional
要求ヘッダーの直後に送信される任意のデータを含むバッファーへのポインター。 このパラメーターは、通常、POST および PUT 操作に使用されます。 オプションのデータには、サーバーにポストされるリソースまたは情報を指定できます。 送信する省略可能なデータがない場合、このパラメーターは NULL を
[in] dwOptionalLength
省略可能なデータのサイズ (バイト単位)。 送信する省略可能なデータがない場合、このパラメーターは 0 にすることができます。
戻り値
成功した場合
備考
HttpSendRequest 指定された要求を HTTP サーバーに送信し、クライアントが要求と共に送信する追加のヘッダーを指定できるようにします。
この関数を使用すると、クライアントは、要求ヘッダーの直後に HTTP サーバーに送信するオプションのデータを指定することもできます。 この機能は、通常、PUT や POST などの "書き込み" 操作に使用されます。
要求が送信されると、HTTP サーバーからの状態コードと応答ヘッダーが読み取られます。 これらのヘッダーは内部的に管理され、HttpQueryInfo 関数を介してクライアント アプリケーションで使用できます。
アプリケーションは、HttpSendRequestを
オフライン モードでは、HttpSendRequest は、リソースがインターネット キャッシュに見つからない場合に ERROR_FILE_NOT_FOUND を返します。
手記
wininet.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして HttpSendRequest を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
要件 | 価値 |
---|---|
サポートされる最小クライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされる最小サーバー | Windows 2000 Server [デスクトップ アプリのみ] |
ターゲット プラットフォーム の |
ウィンドウズ |
ヘッダー | wininet.h |
ライブラリ | Wininet.lib |
DLL | Wininet.dll |
関連項目
WinINet Functions の