Apple Network Setup User Manual
Page 95
C H A P T E R 3
Network Setup Reference
Network Setup Functions
95
dbRef
On input, a value of type
represents a database session previously opened by calling
theClass
On input, a value of type
CfgEntityClass
that specifies the class
for which the notification callback is to be called. For possible
values, see the constants described in “Entity Classes and
Types” (page 104). Constants that define wildcards are valid.
theType
On input, a value of type
CfgEntityType
that specifies the type
for which the notification callback is to be called. For possible
values, see the constants described in “Entity Classes and
Types” (page 104). Constants that define wildcards are valid.
notifier
On input, a value of type
OTNotifyProcPtr
that points to the
notification callback that is to be installed.
contextPtr
On input, a pointer to an arbitrary data type that is passed to the
notification callback when it is called.
function result A value of
noErr
indicates that
OTCfgInstallNotifier
returned
successfully. For a list of other possible result codes, see “Result
Codes” (page 110)
DISCUSSION
The
OTCfgInstallNotifier
function installs a notification callback that is called
when changes to preferences of the specified class and type occur. Calling
OTCfgInstallNotifier
when you have already installed a notification callback
causes the current notification callback to be replaced by the new notification
callback.
Note
The
OTCfgInstallNotifier
function is available in Network
Setup version 1.0.2 and later.
◆
To remove an installed notification callback, call
Notification callbacks are removed automatically when the database session
represented by
dbRef
is closed.