CInternetSession::OpenURL
调用该成员函数将指定的请求到HTTP服务器并允许客户端指定其他RFC822、MIME或HTTP标头随请求一起发送。
CStdioFile* OpenURL(
LPCTSTR pstrURL,
DWORD_PTR dwContext = 1,
DWORD dwFlags = INTERNET_FLAG_TRANSFER_ASCII,
LPCTSTR pstrHeaders = NULL,
DWORD dwHeadersLength = 0
);
参数
pstrURL
对于开始的URL名称的指针读取。从file:、ftp:、gopher:或HTTP启动的仅URL:支持。ASSERTS,如果 pszURL 是 NULL。dwContext
一个应用程序定义的值传递给了与回调的返回的句柄。dwFlags
描述如何处理此连接的标志。请参见 Remarks 有关有效标志的更多信息。有效标志是:INTERNET_FLAG_TRANSFER_ASCII 默认值。调用文件作为ASCII文本。
INTERNET_FLAG_TRANSFER_BINARY 调用文件作为二进制文件。
INTERNET_FLAG_RELOAD 从获取连接的数据,即使本地缓存它。
INTERNET_FLAG_DONT_CACHE 不缓存数据,或是在任何网关。
INTERNET_FLAG_SECURE 此标志适用于HTTP请求。它请求在连接的安全事务和安全套接字层或PCT。
如果可能INTERNET_OPEN_FLAG_USE_EXISTING_CONNECT,重新使用与服务器建立连接 OpenUrl 生成的新请求而不是为每个连接请求的新会话。
INTERNET_FLAG_PASSIVE 为FTP站点改用。使用被动FTP语义。使用 OpenURLCInternetConnection。
pstrHeaders
对包含标头的字符串的指针将发送到HTTP服务器。dwHeadersLength
长度,在字符,则附加标头。如果这是-1L,并 pstrHeaders 非NULL,则 pstrHeaders 假定为终止的零,并且该长度计算。
返回值
仅返回FTP、地鼠、HTTP和文件类型Internet服务的文件句柄。分析,如果不成功,则返回 NULL。
OpenURL 返回的指针取决于 pszURL的类型。下表说明 OpenURL 能返回的指针。
URL 类型 |
返回 |
---|---|
file:// |
CStdioFile* |
http:// |
CHttpFile* |
gopher:// |
CGopherFile* |
ftp:// |
CInternetFile* |
备注
该参数 dwFlags 必须包含 INTERNET_FLAG_TRANSFER_ASCII 或 INTERNET_FLAG_TRANSFER_BINARY,但是,不是两个。其余的标志可以按位组合使用 OR 运算符(|).
OpenURL,用于包装Win32函数 InternetOpenURL,以允许下载,仅检索和读取数据从Internet服务器。OpenURL 不允许在远程位置的文件操作,因此,它不需要 CInternetConnection 对象。
若要使用连接特定(即协议特殊化)功能,如写入文件,就象预期模式必须启动会话,然后打开特定类型的连接,然后使用该连接打开一个文件。请参见 CInternetConnection 有关连接特定功能的更多信息。
异常
此方法会引发类型 **CInternetException***的异常。
要求
Header: afxinet.h