VgaGames 3 - VgaGames3-object man-pages

[.. upper level ..]

VG3_ofunc_objlist_newlist()

Iteration over the list of VgaGames3-objects: Create snapshot of the list.
SYNTAX
struct vg3_ofunc_objsnap * VG3_ofunc_objlist_newlist(struct vg3_ofunc *ofstruct, const char *oid)

FUNCTION PARAMETERS
ofstruct Common VgaGames3-object structure
oid Object-ID or NULL = all objects

RETURN VALUE
Returns a snapshot of the list of VgaGames3-objects, or NULL on failure.

ERRORS
On error VG3_errmsg() returns: EINVAL - error in argument ENOMEM - cannot get memory

DESCRIPTION
For iteration over the list of VgaGames3-objects, using a specific object-ID or all object-instances: Create a snapshot of the list.

SEE ALSO
VG3_ofunc_objlist_nextlist() VG3_ofunc_objlist_freelist()