Software Development Kit (SDK) and API Discussions

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

yuguangw
2,623 Views

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.

1 ACCEPTED SOLUTION

rle
NetApp Alumni
2,623 Views

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 NameRangeTypeDescription
maximuminteger
Maximum number of directory entries to retrieve.
tagstring
Tag from a previous file-list-directory-iter-start.
Output NameRangeTypeDescription
filesfile-info[]
Array with information for each file in the named directory.
recordsinteger
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 NameRangeTypeDescription
tagstring
Tag from a previous file-list-directory-iter-start.
Errno Description
EONTAPI_ENOENT
Vfiler-enabled
Yes

View solution in original post

1 REPLY 1

rle
NetApp Alumni
2,624 Views

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 NameRangeTypeDescription
maximuminteger
Maximum number of directory entries to retrieve.
tagstring
Tag from a previous file-list-directory-iter-start.
Output NameRangeTypeDescription
filesfile-info[]
Array with information for each file in the named directory.
recordsinteger
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 NameRangeTypeDescription
tagstring
Tag from a previous file-list-directory-iter-start.
Errno Description
EONTAPI_ENOENT
Vfiler-enabled
Yes
Public