The header information
returned by this CALL routine identifies the type of the entry and
provides descriptive information.
The ENTRY_FIRST CALL
routine repositions the entry cursor to the start of the list of entries.
When the packages are retrieved by way of the
RETRIEVE_PACKAGE CALL routine, the entry cursor is positioned
at the start of the entry list by default. As a consequence, the ENTRY_FIRST
CALL routine does not have to be called before the
ENTRY_NEXT CALL
routine.
The
userSpecString
parameter is returned to provide further content information about
the entry. The value returned is the value that was provided by the
publisher at insert time. At this time, only file entries can return
a value for this parameter. All other entry types return a blank value.
For file entries, this field is the user-specified MIME type.