---
name: "kdk_printer_get_list"
section: "3"
platform: "linux"
package: "libkysdk-system"
version: "3.0.1.4-1"
release: "Arch Linux 2026-11-07"
platforms: ["linux"]
url: "https://carta.tech/man/kdk_printer_get_list"
---

# kdk\_printer\_get\_list(3)

获取本地的所有打印机(包含可用打印机和不可用打印机)

## NAME

kdk\_printer\_get\_list - 获取本地的所有打印机(包含可用打印机和不可用打印机)

## SYNOPSIS

```
#include <libkyprinter.h>

extern char** kdk_printer_get_list();

Link with -lkyprinter.
```

## Detailed Description

The main function of the interface is to obtain all printers locally (both available and unavailable).

## RETURN VALUE

On success, returns a list of printer names of type char\*\*, ending with a  **NULL** string; Generated by  *alloc* and needs to be recycled by  **kdk\_printer\_freeall**

On error, return **NULL.**

## EXAMPLES

```
#include "libkyprinter.h"
#include <stdio.h>
int main()
{
    int index = 0;
    //获取全部打印机列表
    char **printers = kdk_printer_get_list();
    while (printers[index])
    {
        int status = kdk_printer_get_status(printers[index]);
        printf("%zd: %s , %d0, index + 1, printers[index], status);
        index++;
    }
    kdk_printer_freeall(printers);
    //获取可用打印机列表
    index = 0;
    char **available_printers = kdk_printer_get_available_list();
    while (available_printers[index])
    {
        int status = kdk_printer_get_status(available_printers[index]);
        printf("%zd: %s , %d0, index + 1, available_printers[index], status);
        index++;
    }
    kdk_printer_freeall(available_printers);
    return 0;
}
```

## CONFORMING TO

These functions are as per the withdrawn POSIX.1e draft specification. The following functions are Linux extensions: **kdk\_printer\_get\_available\_list**(), **kdk\_printer\_set\_options**(), **kdk\_printer\_print\_download\_remote\_file**(), **kdk\_printer\_print\_local\_file**(), **kdk\_printer\_cancel\_all\_jobs**(), **kdk\_printer\_get\_status**(), **kdk\_printer\_get\_job\_status**(), **kdk\_printer\_get\_filename**() and **kdk\_printer\_freeall**().

## SEE ALSO

[**kdk\_printer\_get\_available\_list**(3)](/man/kdk_printer_get_available_list/3.md), [**kdk\_printer\_set\_options**(3)](/man/kdk_printer_set_options/3.md), [**kdk\_printer\_print\_download\_remote\_file**(3)](/man/kdk_printer_print_download_remote_file/3.md), [**kdk\_printer\_print\_local\_file**(3)](/man/kdk_printer_print_local_file/3.md), [**kdk\_printer\_cancel\_all\_jobs**(3)](/man/kdk_printer_cancel_all_jobs/3.md), [**kdk\_printer\_get\_status**(3)](/man/kdk_printer_get_status/3.md), [**kdk\_printer\_get\_job\_status**(3)](/man/kdk_printer_get_job_status/3.md), [**kdk\_printer\_get\_filename**(3)](/man/kdk_printer_get_filename/3.md) and [**kdk\_printer\_freeall**(3)](/man/kdk_printer_freeall/3.md).