Carbon


URLCallbackInfo

Header: URLAccess.h

Contains information about a data transfer event.

struct URLCallbackInfo {
    UInt32 version; 
    URLReference urlRef; 
    const char *property; 
    UInt32 currentSize; 
    EventRecord *systemEvent;
};

Field descriptions

version

The version of this structure. This value is currently 0.

urlRef

A reference to the URL associated with the data transfer event.

property

A pointer to a C string representing the name of the URL property that has changed, if relevant. This field is only valid if a property change event occurs as identified by the event constant kURLPropertyChangedEvent, described in “Data Transfer Event Constants”. or a description of name constants and data types of the corresponding property values, see “Universal URL Property Name Constants” and “HTTP and HTTPS URL Property Name Constants”. You should specify this field if the event involves a change in a property value.

currentSize

The current total size (in bytes) of the data that has been downloaded and processed by the client.

systemEvent

A pointer to an event record containing information about the system event that occurred, if relevant. If the event is not a system event, as identified by the event constant kURLSystemEvent, described in “Data Transfer Event Constants”, this field is not valid.

The URLCallbackInfo type represents a structure that contains information about the data transfer event that you want notification of. The URL Access Manager passes a pointer to this structure in the callbackInfo parameter of your notification callback function. For information on how to write a notification callback function, see URLNotifyProcPtr.


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