共用方式為

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
    out 包含標題的字串的指標附加至要求。 必須由一個 CR/LF 組結束每個標題。

  • dwFlags
    修飾詞新標頭的語意。 可以是下列其中一項：

    • HTTP_ADDREQ_FLAG_COALESCE 合併相同名稱的標題，請使用旗標將找到的第一個標題為後續的標題。 例如， 「接受:text/*」後面接著「接受:audio/*」在單一標頭的表單的結果會是「接受:， audio/* text/*」。 它是由呼叫的應用程式保證某個語言的一致的配置所要求接收的資料傳輸 Union 或個別的標題決策。

    • HTTP_ADDREQ_FLAG_REPLACE 執行移除並加入取代目前標題。 標頭名稱來移除目前標頭，，而且的值將新的標頭。 如果標頭值為 null，且找到標頭，則會將它移除。 如果不是，則標頭值取代。

    • 如果檔案不存在，HTTP_ADDREQ_FLAG_ADD_IF_NEW 只加入標頭。 如果存在，就會傳回錯誤。

    • HTTP_ADDREQ_FLAG_ADD 配合取代。 如果不存在，會加入標頭。

  • dwHeadersLen
    的長度，以字元為單位， pstrHeaders。 如果這是-1L，則 pstrHeaders 假設以零結束，且長度計算。

  • str
    對包含要求之標題的 CString 物件的參考將會加入。

傳回值

如果不是零，則成功，則為 0。 如果呼叫失敗， Win32 函式 GetLastError 可以呼叫以判斷錯誤的原因。

備註

此外，AddRequestHeaders 附加至 HTTP 要求控制代碼的自由格式的標題。 適用於需要確切的要求之詳細控制項傳送至 HTTP 伺服器的高階用戶端使用。

注意事項注意事項

使用 HTTP_ADDREQ_FLAG_ADD 或 HTTP_ADDREQ_FLAG_ADD_IF_NEW，應用程式可以在 pstrHeaders 或 str 的多個標頭 AddRequestHeaders 呼叫的。使用 HTTP_ADDREQ_FLAG_REMOVE 或 HTTP_ADDREQ_FLAG_REPLACE，如果應用程式嘗試移除或取代標題，，只有一個標頭。 lpszHeaders來提供。

需求

Header: afxinet.h

請參閱

參考

CHttpFile 類別

階層架構圖表

CInternetFile 類別