CHttpFile::AddRequestHeaders
HTTP 要求の処理に一つ以上の HTTP 要求ヘッダーを追加するには、このメンバー関数を呼び出します。
BOOL AddRequestHeaders(
LPCTSTR pstrHeaders,
DWORD dwFlags = HTTP_ADDREQ_FLAG_ADD_IF_NEW,
int dwHeadersLen = -1
);
BOOL AddRequestHeaders(
CString& str,
DWORD dwFlags = HTTP_ADDREQ_FLAG_ADD_IF_NEW
);
パラメーター
pstrHeaders
要求に追加する、ヘッダーを含む文字列へのポインター。各ヘッダーはフィードのペア終了する必要があります。dwFlags
新しいヘッダーのセマンティクスを修飾します。次のいずれかになります。HTTP_ADDREQ_FLAG_COALESCE、フラグを使用して、検索された後続のヘッダーに最初のヘッダーを追加するには、同じ名前のヘッダーをマージします。たとえば、「承認: 「承認に続く text/*」: audio/*」一つのヘッダーの構成の結果「の使用: text/*」、audio/*。これは、小規模でまとまりの設定を結合すると送信された要求が受信するデータに関する確認するか、またはヘッダーを分離するまで呼び出し元のアプリケーションです。
HTTP_ADDREQ_FLAG_REPLACE は削除を実行し、現在のヘッダーを置き換えるに追加します。ヘッダー名が現在のヘッダーを削除するために使用され、新しいヘッダーを追加するには、完全な値が使用されます。ヘッダー値が空で、ヘッダーがある場合、削除されます。空、ヘッダー値が置き換えられます。
HTTP_ADDREQ_FLAG_ADD_IF_NEW がまだ存在しない場合にのみヘッダーを追加します。が 1 の場合、エラーが返されます。
HTTP_ADDREQ_FLAG_ADD、置換を使用しました。あるヘッダーを追加します。
dwHeadersLen
pstrHeadersの長さ (文字単位)。これは -1L 場合、pstrHeaders は、ゼロで終了すると解釈され、長さが計算されます。str
追加する要求ヘッダーまたはヘッダーを含む CString のオブジェクトへの参照。
戻り値
正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。呼び出しが失敗した場合、エラーの原因を判断するために、Win32 関数 GetLastError が呼び出されるかがあります。
解説
AddRequestHeaders は追加の HTTP 要求のハンドルへの自由形式のヘッダー追加します。これは、HTTP サーバーに送信される厳密な要求の詳細な制御を必要とする高度なクライアントが使用するためのものです。
[!メモ]
アプリケーションは HTTP_ADDREQ_FLAG_ADD か HTTP_ADDREQ_FLAG_ADD_IF_NEWを使用して AddRequestHeaders の呼び出しの pstrHeaders または str の複数のヘッダーを渡すことができます。アプリケーションが HTTP_ADDREQ_FLAG_REMOVE か HTTP_ADDREQ_FLAG_REPLACEを使用して、ヘッダーを削除するか、または置き換える場合、1 種類のヘッダーだけが lpszHeadersで指定できます。
必要条件
Header: afxinet.h