CHttpConnection::OpenRequest

發行項
02/28/2013

呼叫此成員函式開啟 HTTP 連接。

CHttpFile* OpenRequest(
   LPCTSTR pstrVerb,
   LPCTSTR pstrObjectName,
   LPCTSTR pstrReferer = NULL,
   DWORD_PTR dwContext = 1,
   LPCTSTR* ppstrAcceptTypes = NULL,
   LPCTSTR pstrVersion = NULL,
   DWORD dwFlags = INTERNET_FLAG_EXISTING_CONNECT 
);
CHttpFile* OpenRequest(
   int nVerb,
   LPCTSTR pstrObjectName,
   LPCTSTR pstrReferer = NULL,
   DWORD_PTR dwContext = 1,
   LPCTSTR* ppstrAcceptTypes = NULL,
   LPCTSTR pstrVersion = NULL,
   DWORD dwFlags = INTERNET_FLAG_EXISTING_CONNECT 
);

參數

pstrVerb
out 包含動作字串的指標使用在要求。如果為，則使用 NULL「GET」。
pstrObjectName
out 包含指定的動詞命令之目標物件的字串指標這通常是檔名、可執行檔模組或搜尋規範。
pstrReferer
為指定位址的字串的指標 (URL) 文件在要求pstrObjectName(衍生自) 的 URL。如果 NULL，沒有 HTTP 標頭中所指定。
dwContext
OpenRequest 作業的內容識別項。請參閱備註有關 dwContext。
ppstrAcceptTypes
為 Null 終端陣列的指標表示內容類型的字串 LPCTSTR 指標用戶端接受。如果 ppstrAcceptTypes 是 NULL伺服器，說明用戶端只接受型別「text/*」的文件 (亦即只有文字文件圖片 (而不是物件或二進位檔案)。這個內容類型和 CGI 變數 CONTENT_TYPE 相等，識別資料型別為附加查詢資訊，例如 HTTP POST 和放置。
pstrVersion
字串的指標所定義的 HTTP 版本。如果為，則「HTTP/1.0」使用 NULL。
dwFlags
INTERNET_ FLAG_*旗標的組合。針對可能的 dwFlags 值的說明請參閱備註。
nVerb
數字與 HTTP 要求類型。可以是下列其中一項：

HTTP 要求型別

nVerb 值

HTTP_VERB_POST

0

HTTP_VERB_GET

1

HTTP_VERB_HEAD

2

HTTP_VERB_PUT

3

HTTP_VERB_LINK

4

HTTP_VERB_DELETE

5

HTTP_VERB_UNLINK

6

HTTP 要求型別	nVerb 值
HTTP_VERB_POST	0
HTTP_VERB_GET	1
HTTP_VERB_HEAD	2
HTTP_VERB_PUT	3
HTTP_VERB_LINK	4
HTTP_VERB_DELETE	5
HTTP_VERB_UNLINK	6

傳回值

所要求的 CHttpFile 物件的指標。

備註

dwFlags 可以是下列其中一項:

網際網路旗標。	描述
INTERNET_FLAG_RELOAD	強制要求的檔案、物件或目錄清單的下載從原始伺服器，而不是從快取中。
INTERNET_FLAG_DONT_CACHE	不會將傳回的實體加入至快取。
INTERNET_FLAG_MAKE_PERSISTENT	將傳回的實體加入至快取做為持續性實體。這表示標準快取清除，檢查的一致性，否則記憶體回收無法從快取移除項目。
INTERNET_FLAG_SECURE	使用安全交易語意。這只會轉譯為使用 SSL/PCT 且有意義的 HTTP 要求。
INTERNET_FLAG_NO_AUTO_REDIRECT	只用於 HTTP，指定在 CHttpFile::SendRequest不應該自動處理重新導向。

覆寫 dwContext 預設設定內容識別項加入至您所選取的值。內容識別項相關聯的 CInternetSession 物件建立的 CHttpConnection 物件執行特定作業。值會識別的作業會傳回至 CInternetSession::OnStatusCallback 提供狀態。請參閱文件網際網路第一個步驟:WinInet 有關內容識別項的詳細資訊。