Guardian Procedure Errors and Messages Manual

7 PROCESS_GETINFOLIST_ Errors
The PROCESS_GETINFOLIST_ procedure is used to obtain detailed information about a particular
process or about processes within a processor that meet a specified list of search criteria. The
process of interest can be specified either by process handle or by node name, processor number,
and PIN.
The PROCESS_GETINFO_ procedure muist be used when the caller requires only selected
information about a particular process. PROCESS_GETINFO_ returns many of the same errors as
PROCESS_GETINFOLIST_.
When PROCESS_GETINFOLIST_ returns information about one or more processes, the
error-detail parameter contains the number of attributes returned.
Error Codes
This subsection lists each PROCESS_GETINFOLIST_ procedure error code and provides a description
of each code.
0 NO ERROR
Cause The information returned is for the processes specified; the error-detail parameter
contains the number of processes for which information has been returned (which can be more
than one process if in search mode).
Effect None.
Recovery None required.
1 A FILE SYSTEM ERROR OCCURRED
Cause A file-system error occurred; the error-detail parameter contains the file-system error
number. File-system error 563 (buffer too small) is returned if the ret-values-list buffer is too
small to contain all of the requested information.
Effect The procedure sets the error code and returns the error in the error-detail parameter.
Recovery For corrective action for the file-system error returned in the error-detail information,
see “File-System Errors” (page 19).
2 PARAMETER ERROR
Cause The PROCESS_GETINFOLIST_ call contained an illegal combination of options. The
error-detail parameter contains the ordinal number of the first (leftmost) parameter encountered
whose option is in error. Note that parameters are counted in TAL fashion, so nodename:length
is lumped as number 3 and processhandle is number 4. One reason this error can occur with
detail 6 is if an attribute in ret-value-list specifies auxiliary data, which do not fit within the
ret-value-cnt.
Effect The procedure sets the error code and returns without performing the requested operation.
Recovery Correct the call to PROCESS_GETINFOLIST_ so that the options are correct and in the
proper order.
3 BOUNDS ERROR
Cause There was a bounds violation on a reference parameter.
188 PROCESS_GETINFOLIST_ Errors