Apple Network Setup Preference Utilities, Returns as much data as possible and returns the error

C H A P T E R 3

Network Setup Reference

data	On input, a pointer to the buffer into which the default value is
	to be placed. On output, data points to the default value. If the
	buffer is too small to hold the default value, OTCfgGetTemplate
	returns as much data as possible and returns the error
	kCFGErrDataTruncated. If you want to get the size of the default
	value but not the default value itself, set data to NULL.
dataSize	On input, a pointer to a value of type ByteCount. On output,
	dataSize points to the number of bytes in the buffer pointed to
	by data. On input, if data is NULL, on output, dataSize points to
	the size in bytes of the default value for the specified preference.
function result	A value of noErr indicates that OTCfgGetTemplate returned
	successfully. For a list of other possible result codes, see “Result
	Codes” (page 110).

DISCUSSION

The OTCfgGetTemplate function gets the default value for the preference identified by the entityClass, entityType, and prefsType parameters and stores it in the buffer described by data and dataSize.

IMPORTANT

The OTCfgGetTemplate function is available in Network Setup version 1.2 and later. It returns the same data that OTCfgGetDefault (page 90) returns, but the parameters have been changed to be consistent with the parameters of other Network Setup functions. If you rely on Network Setup 1.2 or later, call OTCfgGetTemplate. If you need to work with earlier versions of Network Setup, you can safely continue to call OTCfgGetDefault. ▲

Preference Utilities

Use the following functions to encrypt and decrypt preferences:

■OTCfgDecrypt (page 93) decrypts data.

■OTCfgEncrypt (page 93) encrypts data.

92Network Setup Functions