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,如果 pszURLNULL

  • 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_ASCIIINTERNET_FLAG_TRANSFER_BINARY,但是,不是两个。其余的标志可以按位组合使用 OR 运算符(|).

OpenURL,用于包装Win32函数 InternetOpenURL,以允许下载,仅检索和读取数据从Internet服务器。OpenURL 不允许在远程位置的文件操作,因此,它不需要 CInternetConnection 对象。

若要使用连接特定(即协议特殊化)功能,如写入文件,就象预期模式必须启动会话,然后打开特定类型的连接,然后使用该连接打开一个文件。请参见 CInternetConnection 有关连接特定功能的更多信息。

异常

此方法会引发类型 **CInternetException***的异常。

要求

Header: afxinet.h

请参见

参考

CInternetSession选件类

层次结构图

CInternetConnection选件类

CGopherConnection选件类

CInternetSession::GetFtpConnection

CInternetSession::GetHttpConnection