.TH "KDK_PRINTER_PRINT_DOWNLOAD_REMOTE_FILE" 3 "Fri Aug 25 2023" "Linux Programmer's Manual" \"
.SH NAME
kdk_printer_print_download_remote_file - 下载网络文件
.SH SYNOPSIS
.nf
.B #include <libkyprinter.h>
.sp
.BI "extern int kdk_printer_print_download_remote_file(const char *"url ", const char *"filepath ");"
.sp
Link with \fI\-lkyprinter\fP.
.SH "Detailed Description"
The main function of the interface is to download the network file.
.PP
The argument
.I url
is the url to print.
.PP
The argument
.I filepath
is the path to the saved file.
.SH "RETURN VALUE"
On success, returns the id of the print job of type int.
.PP
On error, return
.BR -1.
.SH EXAMPLES
.EX
#include "libkyprinter.h"
#include <stdio.h>

int main()
{
    int index = 0;
    //获取打印机列表
    char **printers = kdk_printer_get_available_list();
    while (printers[index])
    {
        printf("%zd: %s\n", index + 1, printers[index]);

        //取消当前打印机所有打印任务
        kdk_printer_cancel_all_jobs(printers[index]);

        //获取url对应的文件名
        char *url = "http://www.cztouch.com/upfiles/soft/testpdf.pdf";
        int res = -1;
        char *filename = kdk_printer_get_filename(url); //从完整路径名中解析出文件名称，例如：/home/test/abc.txt,解析完成后为abc.txt
        printf("filename = %s\n", filename);

        //设置打印参数
        kdk_printer_set_options(2, "A4", "lrtb", "two-sided-long-edge");

        //下载
        res = kdk_printer_print_download_remote_file(url, filename);
        printf("[%s] res = %d\n", __FUNCTION__, res);
        printf("[%s] filepath = %s\n", __FUNCTION__, filename);

        //打印
        int job_id = kdk_printer_print_local_file(printers[index], filename);
        if (job_id == 0)
        {   
            //打印失败
            printf("[%s] create print job fail\n", __FUNCTION__);
        }
        else
        {
            //打印成功，等待一会获取任务状态
            sleep(10);
            int status = kdk_printer_get_job_status(printers[index], job_id);
        }

        index++;
        free(filename);
    }
    kdk_printer_freeall(printers);
    return 0;
}

.SH "CONFORMING TO"
These functions are as per the withdrawn POSIX.1e draft specification.
The following functions are Linux extensions:
.BR kdk_printer_get_list (),
.BR kdk_printer_get_available_list (),
.BR kdk_printer_set_options (),
.BR kdk_printer_print_local_file (),
.BR kdk_printer_cancel_all_jobs (),
.BR kdk_printer_get_status (),
.BR kdk_printer_get_job_status (),
.BR kdk_printer_get_filename ()
and
.BR kdk_printer_freeall ().
.SH "SEE ALSO"
.BR kdk_printer_get_list (3),
.BR kdk_printer_get_available_list (3),
.BR kdk_printer_set_options (3),
.BR kdk_printer_print_local_file (3),
.BR kdk_printer_cancel_all_jobs (3),
.BR kdk_printer_get_status (3),
.BR kdk_printer_get_job_status (3),
.BR kdk_printer_get_filename (3)
and
.BR kdk_printer_freeall (3).