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

yuguangw — Thu, 05 Jun 2025 06:27:15 GMT

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.

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

rle — Wed, 16 May 2012 03:25:05 GMT

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

topic What's meaning of 'tag' in the file-list-directory-iter-start() in Software Development Kit (SDK) and API Discussions

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

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