Guardian Procedure Calls Reference Manual

number-of-items
input
INT:value
is the number of items supplied in item-list.
values
input
INT .EXT:ref:*
is the array in which the values for the file attributes specified in item-list are supplied.
The values should be supplied in the order specified in item-list. Each value begins on an
INT boundary; if a value has a length that is an odd number of bytes, then an unused byte
should occur before this value begins. The length of each fixed length value is given in Table 15.
Every variable length item has an associated item that gives its length, as specified in the table.
values-length
input
INT:value
is the size in bytes of values.
partonly
input
INT:value
for partitioned files, specifies whether the attributes be altered for all partitions (if the supplied
value is 0), or just for the named partition (if the value is 1). Nonpartitioned files should use
0. The default is 0.
A value of 1 cannot be specified for some alterations, as noted in Table 15. If an alteration
would affect alternate-key files, a value of 1 prevents this.
error-item
output
INT .EXT:ref:1
if present, returns the index of the item in item-list that was being processed when an error
was detected, or is one greater than the number of items if an error was detected after the
processing of individual items was completed. The index of the first item in item-list is 0.
Returned Value
INT
A file-system error code that indicates the outcome of the call.
FILE_ALTERLIST_ Procedure 347