zip_source_win32handle_create
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 functionszip_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
().
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
] - 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.