QB_HDB_HANDLE_GET(3)

💖 qb_hdb_handle_get — get ur fave instance back (and bump its refcount) 💖

okay so bestie, we're in the libqb Programmer's Manual, section 3, and this page is literally just about one tiny little function that goes and fetches the instance chillin' behind a handle — and then bumps its refcount so nobody yeets it out from under you. no cap. 🫶

---

✨ NAME ✨

qb_hdb_handle_get — Get the instance associated with this handle and increase it's refcount.

---

🎀 SYNOPSIS 🎀

#include <qb/qbhdb.h>

int32_t qb_hdb_handle_get(
    struct qb_hdb   *hdb,        /* the database instance */
    qb_handle_t      handle_in,  /* the handle */
    void           **instance    /* (out) pointer to the desired object. */
);

---

🌸 PARAMS 🌸

• hdb — the database instance. this is the hdb u got ur hands on, ur whole little handle database, the moment. 👑
• handle_in — the handle. the actual handle u want to look up, periodt.
• instance — (out) pointer to the desired object. it's an out param, so the function writes into this — that's where ur object pointer lands. ✨

---

🦋 DESCRIPTION 🦋

ok so ngl, the original page literally leaves this section empty — no prose, nothing, it just goes straight into the struct. so bestie there is no extra lore here, no secret tips, no hidden behaviour notes. we move. 💅

---

💜 STRUCTURES 💜

here's the struct that goes with all this, verbatim, character for character, because we do not mess with the code:

struct qb_hdb {
    uint32_t    handle_count;
    qb_array_t  handles;
    uint32_t    iterator;
    void      (*destructor)(void *);
    uint32_t    first_run;
};

---

🌈 RETURN VALUE 🌈

(0 == ok, -errno failure)

translation: 0 means we ate and everything's fine 💅, anything negative is a failure and it's -errno, so like the negative of whatever errno was. slay.

---

💀 SEE ALSO 💀

go read these too, they're the whole friend group:

• qb_hdb_iterator_reset(3)
• qb_hdb_handle_create(3)
• qb_hdb_handle_destroy(3)
• qb_hdb_handle_refcount_get(3)
• qb_hdb_iterator_next(3)
• qb_hdb_nocheck_convert(3)
• qb_hdb_create(3)
• qb_hdb_destroy(3)
• qb_hdb_base_convert(3)
• qb_hdb_handle_get_always(3)
• qb_hdb_handle_put(3)

---

👑 COPYRIGHT 👑

Copyright (C) 2010-2020 Red Hat, Inc.

---

okay that's the whole page, mwah 🎀 sending u off with the softest little sign-off: this came out of LIBQB, dated 2025-09-16, and it's filed under QB_HDB_HANDLE_GET(3) — go get that handle bestie, it's giving main character energy fr fr 💖✨🦋