Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
ZIP_SOURCE_WIN32HANDLE(3)   Library Functions Manual ZIP_SOURCE_WIN32HANDLE(3)

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 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, usu-
       ally 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 indi-
       cate the	error.

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.

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 <wiz@gatalith.at>

FreeBSD	Ports 14.quarterly	 May 14, 2024	     ZIP_SOURCE_WIN32HANDLE(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=zip_source_win32handle_create&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>

home | help