© Apple Computer, Inc. 2000 INSIDE MACINTOSH Network Setup
10 PREFACE For More Information 0 The following sources provide additional information that may be of interest to developers who use the Network Se
CHAPTER 3 Network Setup Reference100 Network Setup Structures and Data TypesField descriptionsfClass The entity’s class. See “Entity Classes and Types
CHAPTER 3Network Setup ReferenceNetwork Setup Structures and Data Types 101OSType fType;};typedef struct CfgPrefsHeader CfgPrefsHeader;Field descript
CHAPTER 3 Network Setup Reference102 Network Setup Structures and Data Typesstruct CfgSetsStruct{UInt32 fFlags;UInt32 fTimes[ kOTCfgIndexSetsLimit ];}
CHAPTER 3Network Setup ReferenceNetwork Setup Structures and Data Types 103The preference type for the CfgSetsStruct structure is kOTCfgSetsStructPref
CHAPTER 3 Network Setup Reference104 Network Setup ConstantsfElements An unbounded array consisting of the number of CfgSetsElement (page 103) structu
CHAPTER 3Network Setup ReferenceNetwork Setup Constants 105kOTCfgClassSetOfSettings = 'otsc',kOTCfgTypeSetOfSettings = 'otst',};Co
CHAPTER 3 Network Setup Reference106 Network Setup ConstantsConstant descriptionskCfgClassAnyEntity Matches the class type for any entity. This consta
CHAPTER 3Network Setup ReferenceNetwork Setup Constants 107kOTCfgVersionPref Some protocols store the version of the protocol in this preference. Typi
CHAPTER 3 Network Setup Reference108 Network Setup ConstantsSet Entity Preference Types 3The following enumeration defines preference types for set ent
CHAPTER 3Network Setup ReferenceNetwork Setup Constants 109These preferences are used by the Network Setup backward compatibility mechanism to ensure
Network Setup Architecture 11 CHAPTER 1 About Network Setup 1Figure 1-0Listing 1-0Table 1-0 Network Setup is a system service that allows you to mani
CHAPTER 3 Network Setup Reference110 Result CodesResult Codes 3The result codes specific to Network Setup are listed here. Network Setup functions can
Protocol Structures 111CHAPTER 4Network SetupProtocol Structures andData Types 4Figure 4-0Listing 4-0Table 4-0This chapter describes the structures an
CHAPTER 4 Network Setup Protocol Structures and Data Types112 Protocol Structures OTCfgTCPInterfacesPacked (page 114) stores information about the co
CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Structures 113InetHost fIPAddress;InetHost fSubnetMask;Str32
CHAPTER 4 Network Setup Protocol Structures and Data Types114 Protocol StructuresOTCfgTCPInterfacesPacked 4The OTCfgTCPInterfacesPacked structure stor
CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Structures 115struct OTCfgTCPInterfacesPackedPart{UInt8 path[kMaxPortNameSize];UInt8
CHAPTER 4 Network Setup Protocol Structures and Data Types116 Protocol StructuresThe preference type for OTCfgTCPLeaseDHCPInfo is kOTCfgTCPDHCPLeaseIn
CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Structures 117UInt8 pad5;UInt8 lockLocalDomainName;UInt8 pad6;UInt
CHAPTER 4 Network Setup Protocol Structures and Data Types118 Protocol StructureslockRoutersList Set to TRUE to lock the “Router address” text field.pa
CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Structures 119OTCfgTCPRoutersList 4The OTCfgTCPRoutersList structure holds an array
CHAPTER 1 About Network Setup 12 Network Setup Architecture Figure 1-1 Network configuration prior to Network Setup The architecture shown in Figure
CHAPTER 4 Network Setup Protocol Structures and Data Types120 Protocol StructuresOTCfgTCPSearchDomains 4The OTCfgTCPSearchDomains structure stores the
CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Structures 121struct OTCfgTCPSearchList {UInt8 fPrimaryInterfaceIndex;Str255 fLocalD
CHAPTER 4 Network Setup Protocol Structures and Data Types122 Protocol StructureskOTCfgTCPActiveAlwaysLoadedTCP/IP is always loaded.kOTCfgTCPInactive
CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Structures 123 OTCfgRemoteServerPort (page 137) stores core configuration informatio
CHAPTER 4 Network Setup Protocol Structures and Data Types124 Protocol StructuresUInt32 tabChoice;OTCfgUserMode32 fUserMode;UInt32 fSetupVisible;};ver
CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Structures 125OTCfgRemoteClientLocks 4The OTCfgRemoteClientLocks structure stores in
CHAPTER 4 Network Setup Protocol Structures and Data Types126 Protocol StructureserrorCheck The “Allow error correction and compression in modem” chec
CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Structures 127The preference type for this preference is OTCfgRemoteClientLocks, whi
CHAPTER 4 Network Setup Protocol Structures and Data Types128 Protocol StructuresUInt32 showStatus;UInt32 passwordSaved;UInt32 flashConnectedIcon;U
CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Structures 129flashConnectedIcon Set to zero if the menu bar flashes when a disconne
CHAPTER 1 About Network SetupNetwork Setup Architecture 13 Figure 1-2 Network Setup in Mac OS 8.5 through the present The following key points are to
CHAPTER 4 Network Setup Protocol Structures and Data Types130 Protocol StructuressecurityDataLength Must be zero.securityData Must be zero.The prefere
CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Structures 131OTCfgRemoteDialing 4The OTCfgRemoteDialing structure stores settings f
CHAPTER 4 Network Setup Protocol Structures and Data Types132 Protocol StructuresOTCfgRemoteIPCP 4The OTCfgRemoteIPCP structure stores information for
CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Structures 133allowAddressNegotiationMust be 1.idleTimerEnabled Set idleTimerEnabled
CHAPTER 4 Network Setup Protocol Structures and Data Types134 Protocol StructuresUInt32 txACCMap;UInt32 rcACCMap;UInt32 isNoLAPB;};typedef struct OTCf
CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Structures 135OTCfgRemoteLogOptions 4The OTCfgRemoteLogOptions structure controls th
CHAPTER 4 Network Setup Protocol Structures and Data Types136 Protocol Structuresstruct OTCfgRemotePassword {UInt8 data[256];};typedef struct OTCfgRem
CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Structures 137OTCfgRemoteServerPort 4The OTCfgRemoteServerPort structure stores core
CHAPTER 4 Network Setup Protocol Structures and Data Types138 Protocol StructuresserialProtoFlags Serial protocol flags. For possible values, see the
CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Structures 139Str255 fFontName;};typedef struct OTCfgRemoteTerminal OTCfgRemoteTermi
CHAPTER 1 About Network Setup 14 Inside the Network Setup Library remove support for legacy preferences files as soon as possible. Figure 1-3 shows
CHAPTER 4 Network Setup Protocol Structures and Data Types140 Protocol Structuresstruct OTCfgRemoteUserMode {UInt32 version;OTCfgUserMode32 userMode;S
CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Structures 141field, accept either value. When writing the version field, set it to kO
CHAPTER 4 Network Setup Protocol Structures and Data Types142 Protocol StructuresUInt8 pad;FSSpec modemScript;Boolean modemSpeakerOn;Boolean modemPuls
CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Structures 143struct OTCfgModemApplication {UInt32 version;Point windowPos;OTCfgUs
CHAPTER 4 Network Setup Protocol Structures and Data Types144 Protocol Structuresdialing Set dialing to lock the setting for pulse or tone dialing, or
CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Structures 145OTCfgATalkGeneral 4The OTCfgATalkGeneral structure consists of structu
CHAPTER 4 Network Setup Protocol Structures and Data Types146 Protocol StructuresThe preference type for the OTCfgATalkGeneral structure is kOTCfgATal
CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Structures 147fProbeRetryCount The number of times to retry a probe. The default is
CHAPTER 4 Network Setup Protocol Structures and Data Types148 Protocol StructuresfSize Must be the size in bytes of this structure.fDefaultSendBlockin
CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Structures 149No preference type is defined for this structure. Instead, access this
CHAPTER 1 About Network SetupInside the Network Setup Library 15 Figure 1-4 Structure of the Network Setup Library As shown in Figure 1-4, the Networ
CHAPTER 4 Network Setup Protocol Structures and Data Types150 Protocol StructuresFor a detailed description of ASP, see Inside AppleTalk, Second Editi
CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Structures 151fDefaultALOSetting The default “at least once” (ALO) setting. The defa
CHAPTER 4 Network Setup Protocol Structures and Data Types152 Protocol StructuresfTSDUSize The maximum amount of data that packets of this protocol ca
CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Structures 153redefined as a flag, with zero meaning inactive and non-zero meaning act
CHAPTER 4 Network Setup Protocol Structures and Data Types154 Protocol StructuresfSize The size in bytes of this structure.fTSDUSize The maximum amoun
CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Structures 155Field descriptionsfVersion Must be 1.fSize The size in bytes of this s
CHAPTER 4 Network Setup Protocol Structures and Data Types156 Protocol StructuresUInt32 fZoneListInterval;UInt16 fDDPInfoTimeout;UInt8
CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Structures 157The following enumeration defines mask values for the fLocks field:enum
CHAPTER 4 Network Setup Protocol Structures and Data Types158 Protocol StructuresOSType fNetworkArchitecture;};typedef struct OTCfgATalkNetworkArchit
CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Constants and Other Data Types 159OTCfgIRGeneral 4The OTCfgIRGeneral structure store
CHAPTER 1 About Network Setup 16 Network Setup Database Fundamentals Network Setup Database Fundamentals 1 This section describes the fundamental st
CHAPTER 4 Network Setup Protocol Structures and Data Types160 Protocol Constants and Other Data Types “AppleTalk Constants and Other Data Types” (pag
CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Constants and Other Data Types 161kOTCfgTCPDNSServersListPrefPreference type for the
CHAPTER 4 Network Setup Protocol Structures and Data Types162 Protocol Constants and Other Data TypeskOversizeOffNetPacketsMask = 0x0008,kDHCPDon
CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Constants and Other Data Types 163kOTCfgBOOTPConfig Obtain an address from a BOOTP s
CHAPTER 4 Network Setup Protocol Structures and Data Types164 Protocol Constants and Other Data TypeskOTCfgRemoteAlternateAddressPref= 'cead&apos
CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Constants and Other Data Types 165kOTCfgRemoteConnectPrefThe preference type for the
CHAPTER 4 Network Setup Protocol Structures and Data Types166 Protocol Constants and Other Data TypesARA Global Preference Types 4The following enumer
CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Constants and Other Data Types 167Constant descriptionsOTCfgRemotePPPConnectScriptNo
CHAPTER 4 Network Setup Protocol Structures and Data Types168 Protocol Constants and Other Data TypesOTCfgRemoteLogLevel 4The OTCfgRemoteLogLevel stru
CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Constants and Other Data Types 169OTCfgRemoteAnswerMode 4The OTCfgRemoteAnswerMode e
CHAPTER 1 About Network SetupNetwork Setup Database Fundamentals 17 one active set entity . The entities referenced by the active set entity compris
CHAPTER 4 Network Setup Protocol Structures and Data Types170 Protocol Constants and Other Data TypeskOTCfgNetProtoAT Allow AppleTalk connections (ATC
CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Constants and Other Data Types 171Constant descriptionskOTCfgModemGeneralPrefsThe pr
CHAPTER 4 Network Setup Protocol Structures and Data Types172 Protocol Constants and Other Data TypeskModemDialToneIgnore,kModemDialToneManual};Consta
CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Constants and Other Data Types 173enum {kOTCfgATalkGeneralPref = 'atpf',kO
CHAPTER 4 Network Setup Protocol Structures and Data Types174 Protocol Constants and Other Data TypesOTCfgIRPortSetting 4The OTCfgIRPortSetting enumer
175GlossaryAARP See AppleTalk Address Resolution Protocol.Address Resolution Protocol (ARP) The Internet protocol that maps an IP address to a MAC ad
GLOSSARY176Datagram Delivery Protocol (DDP) The network-layer protocol that is responsible for the socket-to-socket delivery of datagrams over an Appl
GLOSSARY177media access control address The six-byte data link layer address that is required for every device that connects to a network. Other devic
GLOSSARY178temporary area An area that is created when a named area is modified.Transmission Control Protocol/Internet Protocol A connection-oriented
179IndexAactive set entityfinding 43–48number of 17, 43ARA constants 163architecture, Network Setup 11–14area IDscomparing 65set entities, working with
CHAPTER 1 About Network Setup 18 Network Setup Database Fundamentals Figure 1-5 Sample organization of the default areaDefault areaAppleTalk global
INDEX180entitiesactive, finding 34active set 17changing 82classes 16classes and types 104closing 85counting 73creating 76deleting 43, 78duplicating 78g
INDEX181KkOTCfgClassNetworkConnection class 30kOTCfgSetsStructPref preference 43kOTCfgSetsVectorPref preference 43Llegacypreference files 13synchroniza
INDEX182OTCfgIRGeneral structure 159OTCfgIsSameAreaID function 65OTCfgIsSameEntityRef function 76OTCfgModemApplication structure 141, 142OTCfgModemLoc
INDEX183set entities 16active, number of 43using 42–49setting entity names 81structuresCfgEntityInfo 99CfgEntityRef 98, 99, 100CfgPrefsHeader 100, 101
CHAPTER 1 About Network SetupNetwork Setup Database Fundamentals 19 For simplicity, this example assumes a computer with two places of operation, hom
Apple Computer, Inc.© 2000 Apple Computer, Inc.All rights reserved. No part of this publication may be reproduced, stored in a retrieval system, or
CHAPTER 1 About Network Setup 20 Network Setup Database Fundamentals reading, it reads the area directly. Network Setup simply notes that the area i
CHAPTER 1 About Network SetupLegacy Issues 21 Preference Coherency 1When an application commits changes to the default area, it is important that app
CHAPTER 1 About Network Setup22 Legacy IssuesGiven that legacy synchronization is slow and that legacy preferences files do not support multihoming, fu
CHAPTER 1About Network SetupNetwork Setup Version History 23entity, it creates a resource containing the preference data with the resource type matchi
CHAPTER 1 About Network Setup24 Network Setup Version History
Opening and Closing the Network Setup Database 25CHAPTER 2Using Network Setup 2Figure 2-0Listing 2-0Table 2-0This chapter explains how to use the Netw
CHAPTER 2 Using Network Setup26 Opening and Closing the Network Setup DatabaseListing 2-1 Opening the database for readingstatic OSStatus MyOpenDataba
CHAPTER 2Using Network SetupOpening and Closing the Network Setup Database 27area, but you can read from both the original area and the writable area
CHAPTER 2 Using Network Setup28 Opening and Closing the Network Setup DatabaseClosing the Database After Reading 2The MyCloseDatabaseAfterReading rout
CHAPTER 2Using Network SetupOpening and Closing the Network Setup Database 29If commit is false, the routine calls OTCfgAbortAreaModifications to disc
3 Contents Figures, Tables, and Listings 7 Preface About This Manual 9Conventions Used in This Manual 9For More Information 10 Chapter 1 About Networ
CHAPTER 2 Using Network Setup30 Working with EntitiesWorking with Entities 2Once you have a reference to the database and an area identifier for the de
CHAPTER 2Using Network SetupWorking with Entities 31 Getting all entities. Set entityClass and entityType to the wildcard values kCfgClassAnyEntity a
CHAPTER 2 Using Network Setup32 Working with EntitiesSetHandleSize( (Handle) entityRefs, entityCount * sizeof(CfgEntityRef) );err = MemError();} if
CHAPTER 2Using Network SetupWorking with Entities 33}}return err;}The next routine, shown in Listing 2-6, opens the database for reading, gets the ent
CHAPTER 2 Using Network Setup34 Reading and Writing PreferencesentityCount = GetHandleSize( (Handle) entityRefs ) / sizeof(CfgEntityRef);for (entityIn
CHAPTER 2Using Network SetupReading and Writing Preferences 35write the desired preferences, and close the entity. This section describes this process
CHAPTER 2 Using Network Setup36 Reading and Writing PreferencesNoteThe sample shown in Listing 2-7, which opens and closes the entity before reading e
CHAPTER 2Using Network SetupReading and Writing Preferences 37IMPORTANTYou can derive the C structure for a specific preference type by removing the “k
CHAPTER 2 Using Network Setup38 Reading and Writing Preferencesby calling OTCfgGetPrefsSize before you read the preference, as shown in Listing 2-10.L
CHAPTER 2Using Network SetupReading and Writing Preferences 39}return err;}Writing Preferences 2Listing 2-11 shows the routine MyWritePref, which demo
4 Writing Preferences 39Iterating the Preferences in an Entity 40Working with Sets 42Finding the Active Set Entity 43Areas and Sets 48Protocol-specifi
CHAPTER 2 Using Network Setup40 Reading and Writing Preferenceserr2 = OTCfgClosePrefs(accessID);if (err == noErr) {err = err2;}}return err;}NoteThe sa
CHAPTER 2Using Network SetupReading and Writing Preferences 41assert(dbRef != nil);assert(entity != nil);prefsTOC = nil;err = OTCfgOpenPrefs(dbRef, e
CHAPTER 2 Using Network Setup42 Working with SetsWorking with Sets 2The Network Setup database uses set entities to store collections of other entity
CHAPTER 2Using Network SetupWorking with Sets 43There are a few basic rules for set entities: Each set entity contains a preference, kOTCfgSetsStruct
CHAPTER 2 Using Network Setup44 Working with SetsThe MyFindActiveSet routine in Listing 2-13 implements the first two steps. It starts by getting a lis
CHAPTER 2Using Network SetupWorking with Sets 45kOTCfgSetsStructPref,&thisStruct, sizeof(thisStruct));if ((err == noErr) && ((thisStruct.f
CHAPTER 2 Using Network Setup46 Working with SetsListing 2-14 Finding the active entity of a given class and typestatic OSStatus MyFindFirstActiveEnti
CHAPTER 2Using Network SetupWorking with Sets 47*activeEntity = (**entitiesInSet).fElements[entityIndex].fEntityRef;OTCfgChangeEntityArea(activeEntity
CHAPTER 2 Using Network Setup48 Working with Setsprintf("User-visible name of active TCP/IP entity = "%#s"\n", userVisibleName);}M
CHAPTER 2Using Network SetupProtocol-specific Topics 49The solution to this problem is very simple: assume that all entity references in a set refer to
5 Chapter 4 Network Setup Protocol Structures and Data Types 111Protocol Structures 111TCP/IP Structures 111Apple Remote Access Structures 122Modem S
CHAPTER 2 Using Network Setup50 Protocol-specific Topics kOTCfgTCPDNSServersListPref, which contains the list of configured DNS servers. For details, s
CHAPTER 2Using Network SetupProtocol-specific Topics 51cursor = (UInt8 *) packedPref;// For each field in the unpacked pref, copy the field to the// pa
CHAPTER 2 Using Network Setup52 Protocol-specific Topicsstatic OSStatus MyUnpackTCPInterfacesPref(const OTCfgTCPInterfacesPacked *packedPref, ByteCount
CHAPTER 2Using Network SetupProtocol-specific Topics 53// If the cursor doesn’t stop at the end of the packed preference data, a data format error occu
CHAPTER 2 Using Network Setup54 Protocol-specific Topics kOTCfgRemoteLogOptionsPref, which contains the “verbose logging” option. For details, see OTC
CHAPTER 2Using Network SetupNotes for Third Parties 55DTS Technote 1119 Serial Port Apocrypha available at http://developer.apple.com/technotes/tn/tn1
CHAPTER 2 Using Network Setup56 Notes for Third Parties
Network Setup Functions 57CHAPTER 3Network Setup Reference 3Figure 3-0Listing 3-0Table 3-0This chapter describes the functions, structures, and data t
CHAPTER 3 Network Setup Reference58 Network Setup FunctionsOTCfgOpenDatabase 3Opens a session with the Network Setup database.OSStatus OTCfgOpenDataba
CHAPTER 3Network Setup ReferenceNetwork Setup Functions 59NoteClosing a database session automatically removes any notification callback that has been
CHAPTER 3 Network Setup Reference60 Network Setup FunctionsIMPORTANTAreas other than the default area (also known as the current area) do not affect a
CHAPTER 3Network Setup ReferenceNetwork Setup Functions 61OTCfgSetCurrentArea 3Sets the default area.OSStatus OTCfgSetCurrentArea (CfgDatabaseRef dbRe
CHAPTER 3 Network Setup Reference62 Network Setup FunctionsdbRef On input, a value of type CfgDatabaseRef (page 98) that represents a database session
CHAPTER 3Network Setup ReferenceNetwork Setup Functions 63OTCfgBeginAreaModifications 3Creates a temporary area for modifying an area.OSStatus OTCfgBeg
CHAPTER 3 Network Setup Reference64 Network Setup FunctionsCall OTCfgCommitAreaModifications (page 64) to write the temporary area to the area identifi
CHAPTER 3Network Setup ReferenceNetwork Setup Functions 65OTCfgAbortAreaModifications 3Closes an area for writing without committing modifications.OSSta
CHAPTER 3 Network Setup Reference66 Network Setup Functionsfunction result A Boolean value that is TRUE if the area IDs are the same and FALSE if the
CHAPTER 3Network Setup ReferenceNetwork Setup Functions 67OTCfgSetAreaName 3Sets the user-visible name of an area.OSStatus OTCfgSetAreaName (CfgDataba
CHAPTER 3 Network Setup Reference68 Network Setup FunctionsOTCfgGetAreasCount 3Obtains the number of areas in the Network Setup database.OSStatus OTCf
CHAPTER 3Network Setup ReferenceNetwork Setup Functions 69that are available. On output, itemCount points to the number of areas for which information
7 Figures, Tables, and Listings Chapter 1 About Network Setup 11 Figure 1-1 Network configuration prior to Network Setup 12 Figure 1-2 Network Setup i
CHAPTER 3 Network Setup Reference70 Network Setup FunctionsOTCfgCreateArea 3Creates an area in the Network Setup database.OSStatus OTCfgCreateArea (Cf
CHAPTER 3Network Setup ReferenceNetwork Setup Functions 71OTCfgDuplicateArea 3Copies the contents of one area to another area.OSStatus OTCfgDuplicateA
CHAPTER 3 Network Setup Reference72 Network Setup FunctionsOTCfgDeleteArea 3Deletes an area in the Network Setup database.OSStatus OTCfgDeleteArea (Cf
CHAPTER 3Network Setup ReferenceNetwork Setup Functions 73 OTCfgDuplicateEntity (page 78) copies the contents of one entity to another entity. OTCfg
CHAPTER 3 Network Setup Reference74 Network Setup FunctionsitemCount On input, a pointer to a value of type ItemCount. On output, itemCount contains t
CHAPTER 3Network Setup ReferenceNetwork Setup Functions 75entityType On input, a value of type CfgEntityType that specifies the type that is to be matc
CHAPTER 3 Network Setup Reference76 Network Setup FunctionsOTCfgIsSameEntityRef 3Compares two entity references.Boolean OTCfgIsSameEntityRef (const Cf
CHAPTER 3Network Setup ReferenceNetwork Setup Functions 77dbRef On input, a value of type CfgDatabaseRef (page 98) that represents a database session
CHAPTER 3 Network Setup Reference78 Network Setup FunctionsOTCfgDeleteEntity 3Deletes the specified entity.OSStatus OTCfgDeleteEntity (CfgDatabaseRef d
CHAPTER 3Network Setup ReferenceNetwork Setup Functions 79entityRef On input, a pointer to a value of type CfgEntityRef (page 99) that identifies the e
CHAPTER 3 Network Setup Reference80 Network Setup Functionsfunction result A value of noErr indicates that OTCfgGetEntityLogicalName returned successf
CHAPTER 3Network Setup ReferenceNetwork Setup Functions 81▲WARNINGThe OTCfgGetEntityName function does not return the user-visible name of the entity.
CHAPTER 3 Network Setup Reference82 Network Setup FunctionsDISCUSSIONThe OTCfgSetEntityName function sets the user-visible name of the specified entity
CHAPTER 3Network Setup ReferenceNetwork Setup Functions 83entityRef On input, a pointer to a value of type CfgEntityRef (page 99) that represents the
CHAPTER 3 Network Setup Reference84 Network Setup FunctionsOTCfgOpenPrefs 3Opens an entity so that its preferences can be accessed.OSStatus OTCCfgOpen
CHAPTER 3Network Setup ReferenceNetwork Setup Functions 85OTCfgClosePrefs 3Closes an entity.OSStatus OTCCfgClosePrefs (CfgEntityAccessID accessID);acc
CHAPTER 3 Network Setup Reference86 Network Setup Functionsfunction result A value of noErr indicates that OTCfgGetPrefsSize returned successfully. Fo
CHAPTER 3Network Setup ReferenceNetwork Setup Functions 87DISCUSSIONThe OTCfgGetPrefs function gets the value of the preference specified by prefsType
CHAPTER 3 Network Setup Reference88 Network Setup FunctionsDISCUSSIONThe OTCfgSetPrefs function sets the preference represented by prefsType to the va
CHAPTER 3Network Setup ReferenceNetwork Setup Functions 89OTCfgGetPrefsTOC 3Gets a list of the preferences in an entity.OSStatus OTCfgGetPrefsTOC (Cfg
9 PREFACE About This Manual This manual describes Network Setup, which is a programming interface that allows you to manipulate the contents of the N
CHAPTER 3 Network Setup Reference90 Network Setup FunctionsOTCfgGetDefault 3Returns a handle containing the default value for a preference.Handle OTCf
CHAPTER 3Network Setup ReferenceNetwork Setup Functions 91accessID On input, a value of type CfgEntityAccessID (page 100), obtained by previously call
CHAPTER 3 Network Setup Reference92 Network Setup Functionsdata On input, a pointer to the buffer into which the default value is to be placed. On out
CHAPTER 3Network Setup ReferenceNetwork Setup Functions 93OTCfgEncrypt 3Encrypts data.SInt16 OTCCfgEncrypt (const UInt8 *key.UInt8 *data,SInt16 dataLe
CHAPTER 3 Network Setup Reference94 Network Setup Functionskey On input, a pointer to a Pascal string containing the encryption key. Usually the encry
CHAPTER 3Network Setup ReferenceNetwork Setup Functions 95dbRef On input, a value of type CfgDatabaseRef (page 98) that represents a database session
CHAPTER 3 Network Setup Reference96 Network Setup FunctionsOTCfgRemoveNotifier 3Removes a notification callback.OSStatus OTCfgRemoveNotifier (CfgDatabas
CHAPTER 3Network Setup ReferenceNetwork Setup Structures and Data Types 97Notification Callback Routine 3Receives notifications of changes to the Networ
CHAPTER 3 Network Setup Reference98 Network Setup Structures and Data Types CfgEntityInfo (page 99), which contains information about the entities in
CHAPTER 3Network Setup ReferenceNetwork Setup Structures and Data Types 99Network Setup uses a value of type CfgAreaID to identify the area in which a
Kommentare zu diesen Handbüchern