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 should 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 Refer to “File-System Errors” (page 19), for corrective action.
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.
186 PROCESS_GETINFOLIST_ Errors
To Next Page
Loading...
