Obtain top scope for an object

ss_pers_topscope is a function defined in sspers.c.

Synopsis:

ss_scope_t * ss_pers_topscope(ss_pers_t *pers, ss_scope_t *buf)

Formal Arguments:

  • pers: Persistent object link to query
  • buf [OUT]: Optional buffer for the result scope link

Description: Every persistent object belongs to a scope, every scope belongs to a file, and every file has one top-scope. This function returns a link to that top-scope.

Return Value: On success, returns a link to the top-scope for pers. If the caller supplied a buffer for the result in the buf argument then that’s the success pointer returned. Returns the null pointer on failure.

Parallel Notes: Independent

See Also: