Apple Network Setup - 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 CfgDatabaseRef (page 98) that
represents a database session previously opened by calling
OTCfgOpenDatabase (page 58).
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 OTCfgRemoveNotifier (page 96).
Notification callbacks are removed automatically when the database session
represented by
dbRef is closed.