ZIP_SOURCE_WIN32HANDLE(3)

ZIP_SOURCE_WIN32HANDLE(3) 💅

okay so bestie, this is a Library Functions Manual page for zip_source_win32handle — section 3 of the libzip man pages. Windows file handles + zip sources. it's giving niche but iconic. let's GO 🦋

---

✨ 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 🌸

so like. the functions zip_source_win32handle() and zip_source_win32handle_create() do the thing where they create a zip source from a Windows file handle 🪟✨

they read len bytes from offset start from it. and if len is 0 or -1, then the whole file (starting from start, obviously, we're not feral) is used. 💖

if the file supports seek, the source can be used to open a zip archive from. lowkey important. 👑

and here's the timing tea: the file is opened and read when the data from the source is used — usually by zip_close() or zip_open_from_source(). so not right this second, bestie. it's a later thing. 🕐

---

🔥 RETURN VALUES 🔥

upon successful completion, the created source is returned. yay!! 🎉

otherwise, NULL is returned and the error code in archive or error is set to indicate the error. sad girl hours. 😭

---

💀 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. 💀

not me noticing the names here are spelled zip_source_w32handle() and zip_source_w32handle_create() — no in, no 32handle... yeah that's literally what the page says, bestie. that's the error section's own spelling. i am simply relaying it, character for character, because that is the vibe and also the rule. 🫶

---

👑 SEE ALSO 👑

libzip(3), zip_file_add(3), zip_file_replace(3), zip_source(5), zip_source_win32a(3), zip_source_win32w(3)

---

🌈 HISTORY 🌈

zip_source_win32handle() and zip_source_win32handle_create() were added in libzip 1.0. throwback!! 🧚

---

💜 AUTHORS 💜

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

---

and that's the whole page, no cap. this one came from Debian, dated May 14, 2024, and it's the ZIP_SOURCE_WIN32HANDLE(3) page — mwah, slay, periodt. 💅✨🎀