zip_source_win32w - Man Page
create data source from a Windows Unicode file name
Library
libzip (-lzip)
Synopsis
#include <zip.h
>
zip_source_t *
zip_source_win32w
(zip_t *archive, const wchar_t *fname, zip_uint64_t start, zip_int64_t len);
zip_source_t *
zip_source_win32w_create
(const wchar_t *fname, zip_uint64_t start, zip_int64_t len, zip_error_t *error);
Description
The functions zip_source_win32w
() and zip_source_win32w_create
() create a zip source on Windows using a Windows Unicode name. They open fname and read len bytes from offset start from it. For a description of the len argument, see zip_source_file(3).
If the file supports seek, the source can be used to open a zip archive from.
The file is opened and read when the data from the source is used, usually by zip_close
() or zip_open_from_source
().
Return Values
Upon successful completion, the created source is returned. Otherwise, NULL
is returned and the error code in archive or error is set to indicate the error.
Errors
zip_source_win32w
() and zip_source_win32w_create
() fail if:
- [ZIP_ER_INVAL]
fname, start, or len are invalid.
- [ZIP_ER_MEMORY]
Required memory could not be allocated.
- [ZIP_ER_OPEN]
Opening fname failed.
See Also
libzip(3), zip_file_add(3), zip_file_replace(3), zip_source(3), zip_source_file(3), zip_source_win32a(3), zip_source_win32handle(3)
History
zip_source_win32w
() was added in libzip 1.0.
ZIP_LENGTH_TO_END
and ZIP_LENGTH_UNCHECKED
were added in libzip 1.10.1.
Authors
Dieter Baron <dillo@nih.at> and Thomas Klausner <wiz@gatalith.at>
Referenced By
zip_source_win32a(3), zip_source_win32handle(3).
The man page zip_source_win32w_create(3) is an alias of zip_source_win32w(3).