DtMmdbLocatorGetSectionObjectIdD(tlMimbdrbaLroycactaolrlG)etSectionObjectId(library call)




 NAME    [Toc]    [Back]
      DtMmdbLocatorGetSectionObjectId - obtains the object identifier of a
      section

 SYNOPSIS    [Toc]    [Back]
      #include <DtMmdb.h>
      DtMmdbHandle* DtMmdbLocatorGetSectionObjectId(
      DtMmdbInfoRequest* request);

 DESCRIPTION    [Toc]    [Back]
      The DtMmdbLocatorGetSectionObjectId function returns the object
      identifier of the specified section.  Use the DtMmdbFreeHandle
      function to release the identifier when it is no longer needed. Table
      lookup is involved because the section identifier is specified by the
      locator_ptr field.

 ARGUMENTS    [Toc]    [Back]
      request   Specifies the bookcase in the bookcase descriptor field and
                the logical identifier of the section in the locator_ptr
                field.

 RETURN VALUE    [Toc]    [Back]
      If DtMmdbLocatorGetSectionObjectId completes successfully, it returns
      a pointer to the object identifier for the section. If it fails, it
      returns a NULL pointer.

 EXAMPLE    [Toc]    [Back]
      The following shows how a DtMmdbLocatorGetSectionObjectId call might
      be coded.

      DtMmdbInfoRequest request;
      /* fill the request */
      DtMmdbLocatorGetSectionObjectId(&request);

 SEE ALSO    [Toc]    [Back]
      TO BE SUPPLIED


                                    - 1 -       Formatted:  January 24, 2005