zip_source_win32w_create(3)

1ZIP_SOURCE_WIN32W(3)     BSD Library Functions Manual     ZIP_SOURCE_WIN32W(3)
2

NAME

4     zip_source_win32w, zip_source_win32w_create — create data source from a
5     Windows Unicode file name
6

LIBRARY

8     libzip (-lzip)
9

SYNOPSIS

11     #include <zip.h>
12
13     zip_source_t *
14     zip_source_win32w(zip_t *archive, const wchar_t *fname,
15         zip_uint64_t start, zip_int64_t len);
16
17     zip_source_t *
18     zip_source_win32w_create(const wchar_t *fname, zip_uint64_t start,
19         zip_int64_t len, zip_error_t *error);
20

DESCRIPTION

22     The functions zip_source_win32w() and zip_source_win32w_create() create a
23     zip source on Windows using a Windows Unicode name.  They open fname and
24     read len bytes from offset start from it.  If len is 0 or -1, the whole
25     file (starting from start) is used.
26
27     If the file supports seek, the source can be used to open a zip archive
28     from.
29
30     The file is opened and read when the data from the source is used, usu‐
31     ally by zip_close() or zip_open_from_source().
32

RETURN VALUES

34     Upon successful completion, the created source is returned.  Otherwise,
35     NULL is returned and the error code in archive or error is set to indi‐
36     cate the error.
37

ERRORS

39     zip_source_win32w() and zip_source_win32w_create() fail if:
40
41     [ZIP_ER_INVAL]     fname, start, or len are invalid.
42
43     [ZIP_ER_MEMORY]    Required memory could not be allocated.
44
45     [ZIP_ER_OPEN]      Opening fname failed.
46

HISTORY

52     zip_source_win32w() was added in libzip 1.0.
53

AUTHORS

55     Dieter Baron <dillo@nih.at> and Thomas Klausner <tk@giga.or.at>
56
57BSD                              June 22, 2018                             BSD