Carbon


NewURLSystemEventUPP

Header: URLAccess.h Carbon status: Supported

Creates a UPP to your system event notification callback.

URLSystemEventUPP NewURLSystemEventUPP (
    URLSystemEventProcPtr userRoutine
);
Parameter descriptions
userRoutine

A pointer to your system event notification callback. For information on how to write your callback, see URLSystemEventProcPtr.

function result

A UPP to your system event notification callback. You can register your callback by passing this UPP in the eventProc parameter of the function URLSimpleDownload, URLSimpleUpload, URLDownload, or URLUpload.

DISCUSSION

The NewURLSystemEventUPP function creates a pointer to your system event callback function. You pass a pointer to your callback function in the eventProc parameter of the functions URLSimpleDownload, URLSimpleUpload, URLDownload, and URLUpload if you want update events to be passed to your application while a dialog box is displayed. (In Mac OS X, this is not necessary, since all dialog boxes are moveable). In order for these functions to display a dialog box, you must set the mask constant kURLDisplayProgressFlag or kURLDisplayAuthFlag in the bitmask passed in the openFlags parameter.

SPECIAL CONSIDERATIONS

When you are finished with your system event notification callback, you should dispose of the UPP by calling the function DisposeURLNotifyUPP.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.


© 2000 Apple Computer, Inc. (Last Updated 7/17/2000)