DTMMDBDLPGETNEXTSECTIONID(3)

💅 DtMmdbDlpGetNextSectionId — like, the next section girlie 💅

okay so bestie, welcome to the DtMmdbDlpGetNextSectionId page — it's a library call, so it's one of those C functions you link against, not a command you type in your shell. Buckle up, she's cute and she's short. 🎀

---

✨ NAME ✨

DtMmdbDlpGetNextSectionId — literally just obtains the object identifier of the next section. that's it, that's the whole vibe. 👑

---

🦋 SYNOPSIS 🦋

#include &<DtMmdb.h>
DtMmdbHandle* DtMmdbDlpGetNextSectionId(
DtMmdbInfoRequest* request);

yes, &<DtMmdb.h> is exactly what's on the page, no I did not fix it, no cap — write it how the manpage says it, bestie. 🙈

---

🌸 DESCRIPTION 🌸

so the DtMmdbDlpGetNextSectionId function returns the object identifier of the next section. you use it to traverse the TOC hierarchy in a depth-first fashion — like scrolling a thread but the thread is a table of contents, iykyk. 🧚

when you're done with the object identifier, call the DtMmdbFreeHandleList function to release the memory. don't leave her hanging, that's a leak and leaks are not it. 💀

heads up: table lookup is involved. so it's doing actual work under the hood, not just vibing.

---

💖 ARGUMENTS 💖

• request — specifies the bookcase in the bookcase_descriptor field, plus the id of the current section in the primary_oid field. that's the whole assignment. 🫶

---

🌈 RETURN VALUE 🌈

if DtMmdbDlpGetNextSectionId completes successfully, it returns a pointer to the object identifier for the next section — or DtMmdbGroundId if there is no next section. like, that's the "you've reached the bottom, nothing to scroll to" signal. 🌟

if it fails? returns a NULL pointer. sad girl hours. 😭

---

⭐ EXAMPLE ⭐

here's how a DtMmdbDlpGetNextSectionId call might be coded, straight up:

DtMmdbHandle* my_oid;
DtMmdbInfoRequest request;
request.bookcase_descriptor = DtMmdbGetBookCase(myInfoLibPtr, "myBase");
request.primary_oid = my_oid;
DtMmdbHandle* x = DtMmdbDlpGetNextSectionId(&&request);
if ( x == DtMMdbGroundId) {
   /* no next section */
} else
  {
   if (x == 0) {
     /* bad request */
  }
  else
  { /* make use of x */
  }

and yes, DtMMdbGroundId with the double-M is exactly how she appears here — copy it character for character, don't be clever, &&request too. 🔥

---

👑 SEE ALSO 👑

• DtMmdbDlpGetPrevSectionId(3) — the other direction, for when you need to go back. she's right there, go say hi. 💜

---

and that's the page, bestie! this was DtMmdbDlpGetNextSectionId in the library call section — the footer's just the same title echoed back at ya, no version number or date to report, so consider this your cute little sign-off. mwah. 💋🎀