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(5), 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).