【千律】API档案：URLDownloadToFile 函数说明

阿飞_Y

已于 2022-04-23 14:13:17 修改

阅读量1.1k

点赞数 1

分类专栏： Windows API档案文章标签： c++ visual studio

于 2022-04-21 17:08:38 首次发布

原文链接：https://www.cctry.com/forum.php?mod=viewthread&tid=298119&extra=page%3D1%26filter%3Dtypeid%26typeid%3D400

版权

Windows API档案专栏收录该内容

6 篇文章

订阅专栏

这篇博客介绍了如何使用URLDownloadToFile API函数从指定URL下载内容并保存到本地文件。该函数涉及到ActiveX组件、URL、文件名、回调接口和错误处理。通过示例代码展示了如何调用此函数，返回值S_OK表示成功，E_OUTOFMEMORY表示内存不足，INET_E_DOWNLOAD_FAILURE表示下载失败。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

简介：
指从指定URL地址读取内容并将读取到的内容保存到特定的文件里。

语法格式：

HRESULT URLDownloadToFile( 
    LPUNKNOWN pCaller,
    LPCTSTR szURL,
    LPCTSTR szFileName,
    DWORD dwReserved,
    LPBINDSTATUSCALLBACK lpfnCB
);

参数：
pCaller：Pointer to the controlling IUnknown interface of the calling Microsoft ActiveX component (if the caller is an ActiveX component).
//该参数为 ActiveX 控件的接口指针，如果当前程序不是 ActiveX 控件则写 NULL 就可以了。

szURL
Pointer to a string value containing the URL to be downloaded. Cannot be set to NULL.
//该参数为要下载的 url 地址，不能为空。

szFileName
Pointer to a string value containing the name of the file to create for bits that come from the download.
//下载文件后，保存的文件名字，包含文件的具体路径信息。

dwReserved
Reserved. Must be set to 0.
//保留字段，必需为0。

lpfnCB
Pointer to the caller's IBindStatusCallback interface. URLDownloadToFile calls this interface's IBindStatusCallback::OnProgress method on a connection activity, including the arrival of data. IBindStatusCallback::OnDataAvailable is never called.
//下载进度状态回调接口的指针。如果要实时监视下载文件的状态那么就要用到这个参数了。

返回值：
S_OK : 成功下载；
E_OUTOFMEMORY：缓冲区长度不够，或者没有足够的内存来完成下载的操作；
INET_E_DOWNLOAD_FAILURE：指定的资源或者回调接口有问题。

实例：

HRESULT hRet = URLDownloadToFile(NULL, "https://s.cctry.com/images/eagle2.png", "D:\\cctry.png", 0, NULL);