Carbon


InvokeURLNotifyUPP

Header: URLAccess.h Carbon status: Supported

Invokes your data transfer event notification callback.

OSStatus InvokeURLNotifyUPP (
    void *userContext, 
    URLEvent event, 
    URLCallbackInfo *callbackInfo, 
    URLNotifyUPP userUPP
);
Parameter descriptions
userContext

A pointer to application-defined storage. The URL Access Manager passes this value in the userContext parameter of your notification callback function. Your application can use this to set up its context when your data transfer event notification callback is called.

event

The data transfer events you want your application to receive. See “Data Transfer Event Constants” for a description of possible values. The URL Access Manager tests the bitmask you pass in the eventRegister parameter of the function URLOpen to determine which events to pass to your callback function. See “Data Transfer Event Mask Constants” for a description of this bitmask.

callbackInfo

A pointer to a structure of type URLCallbackInfo that provides information about the data transfer event to your callback function. The URL Access Manager passes a pointer to this structure in the callbackInfo parameter of your notification callback function.

userUPP

A Universal Procedure Pointer to your data transfer notification callback. For information on how to write this function, see URLNotifyProcPtr.

function result

A result code.

DISCUSSION

The URL Access Manager calls the InvokeURLNotifyUPP function when you pass a UPP to your callback function in the notifyProc parameter of the function URLOpen, and the data transfer event that you specified in the eventRegister parameter occurs.

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)