Returns an array of objects containing information about processes running on a remote machine.
- macOS 10.3+
- Core Services
If the function result is
outcontains information about the failure. See the Core Foundation Reference Documentation for a description of the
In the case of an error, returns
NULL, in which case the
out parameter provides error information. If successful, returns a
CFDictionary objects containing information about the discovered remote processes. Each dictionary contains the URL of a remote application and its human readable name; it may also contain a
CFNumber specifying a user ID for the application, if it has one; and it may also contain a
CFNumber specifying the process ID for the process. The array is owned by the resolver, so you must retain it before disposing of the resolver object itself. For information on the keys for getting information from the dictionary, see Remote Process Dictionary Keys.
You first call
AECreate to obtain a reference to a resolver object you can use to obtain a list of processes running on a specified remote machine. See the description for that function for additional information. You then pass that reference to
AERemote to get an array of objects containing information about the discovered remote processes.
If the resolver was not previously scheduled for execution (by a call to the
AERemote will block until the resulting array is available or an error occurs. If the resolver was previously scheduled but had not yet completed fetching the array, this call will block until the resolver does complete.
Thread safe starting in OS X v10.3.