Carbon


GetProcessSerialNumberFromPortName

Header: EPPC.h Carbon status: Unsupported

Obtains the process serial number of a process.

OSErr GetProcessSerialNumberFromPortName (
    const PPCPortRec *portName, 
    ProcessSerialNumber *pPSN
);
portName

A pointer to a PPC port structure, the contents of which specify the port name registered to a process whose serial number you want.

pPSN

Returns a pointer to the process serial number of the process designated through the portName parameter. You can use the returned process serial number to send a high-level event to that process. Do not interpret the value of the process serial number.

function result

A result code.

DISCUSSION

The GetProcessSerialNumberFromPortName function returns, in the pPSN parameter, a pointer to the process serial number of the process registered at a specific port.

SPECIAL CONSIDERATIONS

The GetProcessSerialNumberFromPortName function does not move or purge memory but for other reasons should not be called from within an interrupt, such as in a completion function or VBL task.

AVAILABILITY

Not supported in Carbon. Not available in Carbon.

CARBON NOTES

The High Level Event APIs (EPPC.h) are not supported in Carbon. Instead, use Apple events.


© 2000 Apple Computer, Inc. — (Last Updated 5/8/2000)