DTMMDBDLPGETPREVSECTIONID(3)

🌸 NAME 🌸

Hey bestie 💖 welcome to the DtMmdbDlpGetPrevSectionId library call page. This one obtains the object identifier of the previous section. Periodt.

---

✨ SYNOPSIS ✨

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

---

💖 DESCRIPTION 💖

So DtMmdbDlpGetPrevSectionId returns the object identifier of the previous section. You can use it to traverse the TOC hierarchy in a depth-first fashion — very main character energy for your table-of-contents walk 🌈.

When you're done with that object identifier and don't need it anymore, use the DtMmdbFreeHandleList function to release the memory. Also heads up: table lookup is involved — not free magic, bestie 💅.

---

🎀 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 vibe check for this argument 🫶.

---

🌈 RETURN VALUE 🌈

If DtMmdbDlpGetPrevSectionId completes successfully, it returns a pointer to the object identifier for the previous section — or DtMmdbGroundId if there is no previous section. Yes, that's a whole different thing from failure, okay? 👑

If it fails, it returns a NULL pointer. So don't go treating every non-success like it's the same, bestie 😭.

---

🧚 EXAMPLE 🧚

The following shows how a DtMmdbDlpGetPrevSectionId call might be coded.

DtMmdbInfoRequest request;
/* fill the request here */
DtMmdbHandle* x = DtMmdbDlpGetPrevSectionId(&&request);
if ( x == DtMMdbGroundId) {
   /* no previous section */
} else
  {
   if (x == 0) {
     /* bad request */
  }
  else
  { /* make use of x */
  }

---

🦋 SEE ALSO 🦋

• DtMmdbDlpGetNextSectionId(3) — the next-section bestie, obviously ✨

---

Later, bestie 🫶💖 — this was the DtMmdbDlpGetPrevSectionId(library call) page footer situation. This copy doesn't print a separate source/version or date line, so that's the cute sign-off: page title only, no extra footer lore 💅🎀.