Apple Network Setup manual On input, a value of type CfgDatabaseRef page 98 that, function result

C H A P T E R 3

Network Setup Reference

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.

Network Setup Functions 95