Carbon


GetPortNameFromProcessSerialNumber

Header: EPPC.h Carbon status: Unsupported

Obtains the port name of a process.

OSErr GetPortNameFromProcessSerialNumber (
    PPCPortRec *portName, 
    const ProcessSerialNumber *pPSN
);
Parameter descriptions
portName

Returns a pointer to a PPC port structure, the contents of which specify the port name of the process designated by the pPSN parameter. You can use the returned port name to send a high-level event to that process.

pPSN

A pointer to the process serial number of the process whose port name you want.

function result

A result code.

DISCUSSION

The GetPortNameFromProcessSerialNumber function returns, through the portName parameter, the port name registered to a process having a specific process serial number.

SPECIAL CONSIDERATIONS

The GetPortNameFromProcessSerialNumber 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 6/30/2000)