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

Authors

       Dieter Baron <dillo@nih.at> and Thomas Klausner <wiz@gatalith.at>

Debian                                            May 14, 2024                         ZIP_SOURCE_WIN32HANDLE(3)

Description

       The  functions  zip_source_win32handle()  and  zip_source_win32handle_create() create a zip source from a
       Windows file handle.  They 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().

Errors

zip_source_w32handle() and zip_source_w32handle_create() fail if:

       [ZIP_ER_INVAL]     h, start, or len are invalid.

       [ZIP_ER_MEMORY]    Required memory could not be allocated.

History

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

Library

       libzip (-lzip)

Name

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

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.

Synopsis

#include<zip.h>zip_source_t*zip_source_win32handle(zip_t*archive, HANDLEh, zip_uint64_tstart, zip_int64_tlen);

       zip_source_t*zip_source_win32handle_create(HANDLEh, zip_uint64_tstart, zip_int64_tlen, zip_error_t*error);