"Fossies" - the Fresh Open Source Software Archive

Member "libzip-1.5.2/man/zip_source_win32handle.man" (12 Mar 2019, 3766 Bytes) of package /linux/misc/libzip-1.5.2.tar.xz:


Caution: As a special service "Fossies" has tried to format the requested manual source page into HTML format but links to other man pages may be missing or even erroneous. Alternatively you can here view or download the uninterpreted manual source code. A member file download can also be achieved by clicking within a package contents listing on the according byte size field. See also the latest Fossies "Diffs" side-by-side code changes report for "zip_source_win32handle.man": 1.5.1_vs_1.5.2.

ZIP_SOURCE_WIN32HANDLE

NAME
LIBRARY
SYNOPSIS
DESCRIPTION
RETURN VALUES
ERRORS
SEE ALSO
HISTORY
AUTHORS

NAME

zip_source_win32handle, zip_source_win32handle_create − create data source from a Windows file handle

LIBRARY

libzip (-lzip)

SYNOPSIS

#include <zip.h>

zip_source_t *

zip_source_win32handle(zip_t *archive, HANDLE h, zip_uint64_t start, zip_int64_t len);

zip_source_t *

zip_source_win32handle_create(HANDLE h, zip_uint64_t start, zip_int64_t len, zip_error_t *error);

DESCRIPTION

The functions zip_source_win32handle() and zip_source_win32handle_create() create a zip source from a Windows file handle. They open fname and read len bytes from offset start from it. If len is 0 or −1, the whole file (starting from start) is used.

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_w32handle() and zip_source_w32handle_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_win32a(3), zip_source_win32w(3)

HISTORY

zip_source_win32handle() and zip_source_win32handle_create() were added in libzip 1.0.

AUTHORS

Dieter Baron <dillo@nih.at> and Thomas Klausner <tk@giga.or.at>