Passes the process identification number (PIN) of the process for which
information is to be returned in the item parameter. A
zero returns information about the calling process.
This parameter is not compatible with the pin parameter
of the GETPROCINFO intrinsic.
Required parameter address (other than
error1) out of bounds
Not used
4
Illegal array size
Array size passed to PROCINFO
5
Invalid itemnum
Index of offending itemnum
6
Invalid PIN; no information returned
-1
7
Unassigned PIN
-1
8
Unpaired itemnum,item parameters
Index of offending itemnum,item parameters
9
Invalid access to information
-1
10
Invalid address entered for item
Index of offending itemnum,item parameters
11
The process name cannot be represented using
the desired syntax
Index of offending itemnum,item parameters
NOTE: The process aborts if the error1 parameter address
is illegal.
If an error condition is detected while processing an information request, the
index of the itemnum, where the offending option was located,
is stored in error2.
Process identification number (PIN) of the parent of the process
specified by pin.
If the calling process is executing in privileged mode, requests for
information are honored for any process. Otherwise, requests are honored as
follows:
Complete information is returned for children of the calling
process.
Information returned for descendants below children (grandchildren,
great-grandchildren, and so on) and processes directly above the
calling process is limited to itemnums 2 through 7,
10, and 12 only. Process handling capability is required for any user
mode call unless the calling process is requesting information about
itself.
Number of children of the process specified by pin.
If the calling process is executing in privileged mode, requests for
information are honored for any process. Otherwise, requests are honored as
follows:
Complete information is returned for children of the calling
process.
Information returned for descendants below children (grandchildren,
great-grandchildren, and so on) and processes directly above the
calling process is limited to itemnums 2 through 7,
10, and 12 only. Process handling capability is required for any user
mode call unless the calling process is requesting information about
itself.
Number of descendants (children, grandchildren, and so on) of the
process specified by pin.
If the calling process is executing in privileged mode, requests for
information are honored for any process. Otherwise, requests are honored as
follows:
Complete information is returned for children of the calling
process.
Information returned for descendants below children (grandchildren,
great-grandchildren, and so on) and processes directly above the
calling process is limited to itemnums 2 through 7,
10, and 12 only. Process handling capability is required for any user
mode call unless the calling process is requesting information about
itself.
Number of generations (number of levels in the process tree
substructure), including itself, of the process specified by
pin.
If the calling process is executing in privileged mode, requests for
information are honored for any process. Otherwise, requests are honored as
follows:
Complete information is returned for children of the calling
process.
Information returned for descendants below children (grandchildren,
great-grandchildren, and so on) and processes directly above the
calling process is limited to itemnums 2 through 7,
10, and 12 only. Process handling capability is required for any user
mode call unless the calling process is requesting information about
itself.
Process identification numbers (PINs) of all children of the process
specified by pin.
A variable number of PINs are returned; item must be a
16-bit signed integer array. The first element of the array must be set by
the calling process to indicate the array size. The array size should
include the array size element (for example, for four PINs, the first entry
that contains the array size should be 5). PINs are stored into the array,
one PIN per element, starting with the second element and continuing until
the array is filled or all PINs are returned. If the array is not filled,
the remaining unused elements are padded with zeros.
If the calling process is executing in privileged mode, requests for
information are honored for any process. Otherwise, requests are honored as
follows:
Complete information is returned for children of the calling
process.
Information returned for descendants below children (grandchildren,
great-grandchildren, and so on) and processes directly above the
calling process is limited to itemnums 2 through 7,
10, and 12 only. Process handling capability is required for any user
mode call unless the calling process is requesting information about
itself.
Process identification numbers (PINs) of all descendants below children,
grandchildren, and so on) of the process specified by pin.
A variable number of PINs are returned; item must be a
16-bit signed integer array. The first element of the array must be set by
the calling process to indicate the array size. The array size should
include the array size element (for example, for four PINs, the first entry
that contains the array size should be 5). PINs are stored into the array,
one PIN per element, starting with the second element and continuing until
the array is filled or all PINs are returned. If the array is not filled,
the remaining unused elements are padded with zeros.
If the calling process is executing in privileged mode, requests for
information are honored for any process. Otherwise, requests are honored as
follows:
Complete information is returned for children of the calling
process.
Information returned for descendants below children (grandchildren,
great-grandchildren, and so on) and processes directly above the
calling process is limited to itemnums 2 through 7,
10, and 12 only. Process handling capability is required for any user
mode call unless the calling process is requesting information about
itself.
Program name that the process specified by pin is
currently executing.
The character array for the program name must be a minimum of 28 bytes long.
The name is returned in the form file.group.account, where
file is the local file name, group is the
group name, and account is the account name of the file
containing the program that the specified process is currently executing.
The name is returned left-justified with the unused locations filled with
blanks.
If the calling process is executing in privileged mode, requests for
information are honored for any process. Otherwise, requests are honored as
follows:
Complete information is returned for children of the calling
process.
Information returned for descendants below children (grandchildren,
great-grandchildren and so on) and processes directly above the
calling process is limited to itemnums 2 through 7,
10, and 12 only. Process handling capability is required for any user
mode call unless the calling process is requesting information about
itself.
Returns a null-terminated HFS-syntax absolute pathname that the process
specified by pin is currently executing.
On input, the first four bytes of the buffer are interpreted as a signed
integer specifying the maximum bufffer size in bytes. The maximum buffer
size does not include the four bytes used to represent the size.
On output, the first four bytes of the buffer represent the pathname length
excluding the null-terminator as a signed integer. The pathname is returned
in the bytes following the pathname length. Bytes beyond the null-terminator
should be considered undefined.
If the maximum buffer length is not correct on input, variables allocated
near the buffer can be overwritten, or an error occurs. If the process name
is not expressed using HFS syntax, an error is returned in the first four
bytes of the buffer.
If the calling process is executing in privilege mode, requests for
information are honored for any process. Otherwise, requests are honored as
follows:
Complete information is returned for children of the calling
process itself.
Information returned for descendants below children (grandchildren,
great-grandchildren, and so on) and processes directly above the
calling process is limited to itemnums 2 through 7,
10, and 12 only. Process handling capability is required for any user
mode call unless the calling process is requesting information about
itself.