DTMMDBTOCGETCHILDIDS(3)

💖 NAME 💖

okay so this is the DtMmdbTocGetChildIds page from the (library call) manual, bestie — and the function literally obtains a list of object identifiers for child sections. no cap, that's the whole name vibe 🫶

✨ SYNOPSIS ✨

like, here's the include and signature, exactly:

#include &<DtMmdb.h>
DtMmdbHandle** DtMmdbTocGetChildIds(
DtMmdbInfoRequest* request,
unsigned int* length);

🦋 DESCRIPTION 🦋

The DtMmdbTocGetChildIds function returns an array of the object identifiers for the child sections belonging to the specified section. Use the DtmmdbFreeHandleList to release the array when it is no longer needed.

🎀 ARGUMENTS 🎀

• request — specifies the bookcase in the bookcase descriptor field, and the section's Database Engine identifier in the primary_oid field. yes, both of those live in the request, bestie.
• length — specifies the variable to receive the length of the returned array (in bytes), if the returned pointer to the array is not NULL. If it is set to zero, the section has no child section. periodt.

🔥 RETURN VALUE 🔥

If DtMmdbTocGetChildIds completes successfully, it returns a NULL-terminated object identifier array. If it fails, it returns a NULL pointer. slay when it works, sad little NULL when it doesn't 😭

🌈 EXAMPLE 🌈

The following shows how a DtMmdbTocGetChildIds call might be coded.

DtMmdbInfoRequest request; unsigned int length;
/* fill the request here */
handleList = DtMmdbTocGetChildIds(&&request, &&length);

👀 SEE ALSO 👀

• TO BE SUPPLIED

(iconic mystery, honestly — the page really says TO BE SUPPLIED.)

---

💖 and that's the whole DtMmdbTocGetChildIds(library call) page, bestie — the footer is literally just that same title line again, so there's no extra source/version or date line to report. bye babes 🫶✨