What's meaning of 'tag' in the file-list-directory-iter-start()

[yuguangw]

Hi,

One of our partner are develop base on SDK ,but they met some questions.
When they call file-list-directory-iter-start with same parameter, and got different TAG value in the returned XML every time, as below picture.

So what’s meaning of the “tag”?

Thanks for your help.

[rle · Accepted solution]

The tag is used file-list-directory-iter-next and file-list-directory-iter-end.

file-list-directory-iter-next

[top]

Obtain a list of files in a given directory.

Input Name	Range	Type	Description
maximum		integer	Maximum number of directory entries to retrieve.
tag		string	Tag from a previous file-list-directory-iter-start.
Output Name	Range	Type	Description
files		file-info[]	Array with information for each file in the named directory.
records		integer	This tells you how many records are being returned from this particular call to file-list-directory-iter-next. When this value is 0, you have retrieved everything.

Errno	Description
EONTAPI_ENOENT

Vfiler-enabled

Yes

file-list-directory-iter-end

[top]

Terminate a directory iteration.

Input Name	Range	Type	Description
tag		string	Tag from a previous file-list-directory-iter-start.

Errno	Description
EONTAPI_ENOENT

Vfiler-enabled

Yes