company logo

DictionaryHandle :: LocateExtentDef - Provide extend definition

The function returns the extend definition for the passed extent name from the internal dictionary. When the extent definition has not been found in the internal dictionary the function will provide the extent definition in the internal dictionary by reading it from the external dictionary.

In contrast to ProvideExtentDef () the function does not set a system error when the extent definition could not be found.

Return value:  Internal extent definition ( DBExtend * )

Implementation details

DBExtend * DictionaryHandle  :: LocateExtentDef ( NString &extname, int32 namespace_id )
  • extname - Extent name

    The name contains the name of the extent, only. It does not contain a namespace scope.

    Notes:

    retval checked for const &NString

  • namespace_id - Internal namespace number