Apple Network Setup Manuel d'utilisateur

Naviguer en ligne ou télécharger Manuel d'utilisateur pour Matériel Apple Network Setup. Apple Network Setup User Manual Manuel d'utilisatio

  • Télécharger
  • Ajouter à mon manuel
  • Imprimer
  • Page
    / 184
  • Table des matières
  • MARQUE LIVRES
  • Noté. / 5. Basé sur avis des utilisateurs

Résumé du contenu

Page 1 - Network Setup

 © Apple Computer, Inc. 2000  INSIDE MACINTOSH Network Setup

Page 2

10 PREFACE For More Information 0 The following sources provide additional information that may be of interest to developers who use the Network Se

Page 3 - Contents

CHAPTER 3 Network Setup Reference100 Network Setup Structures and Data TypesField descriptionsfClass The entity’s class. See “Entity Classes and Types

Page 4

CHAPTER 3Network Setup ReferenceNetwork Setup Structures and Data Types 101OSType fType;};typedef struct CfgPrefsHeader CfgPrefsHeader;Field descript

Page 5 - Chapter 4

CHAPTER 3 Network Setup Reference102 Network Setup Structures and Data Typesstruct CfgSetsStruct{UInt32 fFlags;UInt32 fTimes[ kOTCfgIndexSetsLimit ];}

Page 6

CHAPTER 3Network Setup ReferenceNetwork Setup Structures and Data Types 103The preference type for the CfgSetsStruct structure is kOTCfgSetsStructPref

Page 7 - Figures, Tables, and Listings

CHAPTER 3 Network Setup Reference104 Network Setup ConstantsfElements An unbounded array consisting of the number of CfgSetsElement (page 103) structu

Page 8

CHAPTER 3Network Setup ReferenceNetwork Setup Constants 105kOTCfgClassSetOfSettings = 'otsc',kOTCfgTypeSetOfSettings = 'otst',};Co

Page 9 - About This Manual

CHAPTER 3 Network Setup Reference106 Network Setup ConstantsConstant descriptionskCfgClassAnyEntity Matches the class type for any entity. This consta

Page 10 - For More Information 0

CHAPTER 3Network Setup ReferenceNetwork Setup Constants 107kOTCfgVersionPref Some protocols store the version of the protocol in this preference. Typi

Page 11 - About Network Setup 1

CHAPTER 3 Network Setup Reference108 Network Setup ConstantsSet Entity Preference Types 3The following enumeration defines preference types for set ent

Page 12

CHAPTER 3Network Setup ReferenceNetwork Setup Constants 109These preferences are used by the Network Setup backward compatibility mechanism to ensure

Page 13

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

Page 14 - CHAPTER 1

CHAPTER 3 Network Setup Reference110 Result CodesResult Codes 3The result codes specific to Network Setup are listed here. Network Setup functions can

Page 15

Protocol Structures 111CHAPTER 4Network SetupProtocol Structures andData Types 4Figure 4-0Listing 4-0Table 4-0This chapter describes the structures an

Page 16 - Database Structure 1

CHAPTER 4 Network Setup Protocol Structures and Data Types112 Protocol Structures OTCfgTCPInterfacesPacked (page 114) stores information about the co

Page 17 - Database Structure Example 1

CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Structures 113InetHost fIPAddress;InetHost fSubnetMask;Str32

Page 18

CHAPTER 4 Network Setup Protocol Structures and Data Types114 Protocol StructuresOTCfgTCPInterfacesPacked 4The OTCfgTCPInterfacesPacked structure stor

Page 19 - Database Operations 1

CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Structures 115struct OTCfgTCPInterfacesPackedPart{UInt8 path[kMaxPortNameSize];UInt8

Page 20

CHAPTER 4 Network Setup Protocol Structures and Data Types116 Protocol StructuresThe preference type for OTCfgTCPLeaseDHCPInfo is kOTCfgTCPDHCPLeaseIn

Page 21

CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Structures 117UInt8 pad5;UInt8 lockLocalDomainName;UInt8 pad6;UInt

Page 22 - Legacy Issues

CHAPTER 4 Network Setup Protocol Structures and Data Types118 Protocol StructureslockRoutersList Set to TRUE to lock the “Router address” text field.pa

Page 23

CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Structures 119OTCfgTCPRoutersList 4The OTCfgTCPRoutersList structure holds an array

Page 24 - Network Setup Version History

CHAPTER 1 About Network Setup 12 Network Setup Architecture Figure 1-1 Network configuration prior to Network Setup The architecture shown in Figure

Page 25 - Using Network Setup 2

CHAPTER 4 Network Setup Protocol Structures and Data Types120 Protocol StructuresOTCfgTCPSearchDomains 4The OTCfgTCPSearchDomains structure stores the

Page 26 - Using Network Setup

CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Structures 121struct OTCfgTCPSearchList {UInt8 fPrimaryInterfaceIndex;Str255 fLocalD

Page 27

CHAPTER 4 Network Setup Protocol Structures and Data Types122 Protocol StructureskOTCfgTCPActiveAlwaysLoadedTCP/IP is always loaded.kOTCfgTCPInactive

Page 28

CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Structures 123 OTCfgRemoteServerPort (page 137) stores core configuration informatio

Page 29

CHAPTER 4 Network Setup Protocol Structures and Data Types124 Protocol StructuresUInt32 tabChoice;OTCfgUserMode32 fUserMode;UInt32 fSetupVisible;};ver

Page 30 - Working with Entities 2

CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Structures 125OTCfgRemoteClientLocks 4The OTCfgRemoteClientLocks structure stores in

Page 31 - Working with Entities 31

CHAPTER 4 Network Setup Protocol Structures and Data Types126 Protocol StructureserrorCheck The “Allow error correction and compression in modem” chec

Page 32 - 32 Working with Entities

CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Structures 127The preference type for this preference is OTCfgRemoteClientLocks, whi

Page 33 - Working with Entities 33

CHAPTER 4 Network Setup Protocol Structures and Data Types128 Protocol StructuresUInt32 showStatus;UInt32 passwordSaved;UInt32 flashConnectedIcon;U

Page 34 - Finding an Active Entity 2

CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Structures 129flashConnectedIcon Set to zero if the menu bar flashes when a disconne

Page 35

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

Page 36

CHAPTER 4 Network Setup Protocol Structures and Data Types130 Protocol StructuressecurityDataLength Must be zero.securityData Must be zero.The prefere

Page 37

CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Structures 131OTCfgRemoteDialing 4The OTCfgRemoteDialing structure stores settings f

Page 38 - Listing 2-10

CHAPTER 4 Network Setup Protocol Structures and Data Types132 Protocol StructuresOTCfgRemoteIPCP 4The OTCfgRemoteIPCP structure stores information for

Page 39 - Writing Preferences 2

CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Structures 133allowAddressNegotiationMust be 1.idleTimerEnabled Set idleTimerEnabled

Page 40

CHAPTER 4 Network Setup Protocol Structures and Data Types134 Protocol StructuresUInt32 txACCMap;UInt32 rcACCMap;UInt32 isNoLAPB;};typedef struct OTCf

Page 41

CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Structures 135OTCfgRemoteLogOptions 4The OTCfgRemoteLogOptions structure controls th

Page 42 - Working with Sets 2

CHAPTER 4 Network Setup Protocol Structures and Data Types136 Protocol Structuresstruct OTCfgRemotePassword {UInt8 data[256];};typedef struct OTCfgRem

Page 43 - Working with Sets 43

CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Structures 137OTCfgRemoteServerPort 4The OTCfgRemoteServerPort structure stores core

Page 44 - Working with Sets

CHAPTER 4 Network Setup Protocol Structures and Data Types138 Protocol StructuresserialProtoFlags Serial protocol flags. For possible values, see the

Page 45 - Working with Sets 45

CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Structures 139Str255 fFontName;};typedef struct OTCfgRemoteTerminal OTCfgRemoteTermi

Page 46 - 46 Working with Sets

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

Page 47 - Working with Sets 47

CHAPTER 4 Network Setup Protocol Structures and Data Types140 Protocol Structuresstruct OTCfgRemoteUserMode {UInt32 version;OTCfgUserMode32 userMode;S

Page 48 - Areas and Sets 2

CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Structures 141field, accept either value. When writing the version field, set it to kO

Page 49 - Protocol-specific Topics 2

CHAPTER 4 Network Setup Protocol Structures and Data Types142 Protocol StructuresUInt8 pad;FSSpec modemScript;Boolean modemSpeakerOn;Boolean modemPuls

Page 50 - Protocol-specific Topics

CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Structures 143struct OTCfgModemApplication {UInt32 version;Point windowPos;OTCfgUs

Page 51 - Protocol-specific Topics 51

CHAPTER 4 Network Setup Protocol Structures and Data Types144 Protocol Structuresdialing Set dialing to lock the setting for pulse or tone dialing, or

Page 52 - 52 Protocol-specific Topics

CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Structures 145OTCfgATalkGeneral 4The OTCfgATalkGeneral structure consists of structu

Page 53 - Remote Access Notes 2

CHAPTER 4 Network Setup Protocol Structures and Data Types146 Protocol StructuresThe preference type for the OTCfgATalkGeneral structure is kOTCfgATal

Page 54 - Modem Notes 2

CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Structures 147fProbeRetryCount The number of times to retry a probe. The default is

Page 55 - Notes for Third Parties 2

CHAPTER 4 Network Setup Protocol Structures and Data Types148 Protocol StructuresfSize Must be the size in bytes of this structure.fDefaultSendBlockin

Page 56 - 56 Notes for Third Parties

CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Structures 149No preference type is defined for this structure. Instead, access this

Page 57 - Network Setup Reference 3

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

Page 58 - OTCfgCloseDatabase 3

CHAPTER 4 Network Setup Protocol Structures and Data Types150 Protocol StructuresFor a detailed description of ASP, see Inside AppleTalk, Second Editi

Page 59 - Managing Areas 3

CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Structures 151fDefaultALOSetting The default “at least once” (ALO) setting. The defa

Page 60 - OTCfgGetCurrentArea 3

CHAPTER 4 Network Setup Protocol Structures and Data Types152 Protocol StructuresfTSDUSize The maximum amount of data that packets of this protocol ca

Page 61 - OTCfgOpenArea 3

CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Structures 153redefined as a flag, with zero meaning inactive and non-zero meaning act

Page 62 - OTCfgCloseArea 3

CHAPTER 4 Network Setup Protocol Structures and Data Types154 Protocol StructuresfSize The size in bytes of this structure.fTSDUSize The maximum amoun

Page 63 - OTCfgBeginAreaModifications 3

CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Structures 155Field descriptionsfVersion Must be 1.fSize The size in bytes of this s

Page 64 - OTCfgCommitAreaModifications 3

CHAPTER 4 Network Setup Protocol Structures and Data Types156 Protocol StructuresUInt32 fZoneListInterval;UInt16 fDDPInfoTimeout;UInt8

Page 65 - OTCfgIsSameAreaID 3

CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Structures 157The following enumeration defines mask values for the fLocks field:enum

Page 66 - OTCfgGetAreaName 3

CHAPTER 4 Network Setup Protocol Structures and Data Types158 Protocol StructuresOSType fNetworkArchitecture;};typedef struct OTCfgATalkNetworkArchit

Page 67 - OTCfgSetAreaName 3

CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Constants and Other Data Types 159OTCfgIRGeneral 4The OTCfgIRGeneral structure store

Page 68 - OTCfgGetAreasList 3

CHAPTER 1 About Network Setup 16 Network Setup Database Fundamentals Network Setup Database Fundamentals 1 This section describes the fundamental st

Page 69 - Network Setup Functions 69

CHAPTER 4 Network Setup Protocol Structures and Data Types160 Protocol Constants and Other Data Types “AppleTalk Constants and Other Data Types” (pag

Page 70 - OTCfgCreateArea 3

CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Constants and Other Data Types 161kOTCfgTCPDNSServersListPrefPreference type for the

Page 71 - OTCfgDuplicateArea 3

CHAPTER 4 Network Setup Protocol Structures and Data Types162 Protocol Constants and Other Data TypeskOversizeOffNetPacketsMask = 0x0008,kDHCPDon

Page 72 - Managing Entities 3

CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Constants and Other Data Types 163kOTCfgBOOTPConfig Obtain an address from a BOOTP s

Page 73 - OTCfgGetEntitiesCount 3

CHAPTER 4 Network Setup Protocol Structures and Data Types164 Protocol Constants and Other Data TypeskOTCfgRemoteAlternateAddressPref= 'cead&apos

Page 74 - OTCfgGetEntitiesList 3

CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Constants and Other Data Types 165kOTCfgRemoteConnectPrefThe preference type for the

Page 75 - Network Setup Functions 75

CHAPTER 4 Network Setup Protocol Structures and Data Types166 Protocol Constants and Other Data TypesARA Global Preference Types 4The following enumer

Page 76 - OTCfgCreateEntity 3

CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Constants and Other Data Types 167Constant descriptionsOTCfgRemotePPPConnectScriptNo

Page 77 - Network Setup Functions 77

CHAPTER 4 Network Setup Protocol Structures and Data Types168 Protocol Constants and Other Data TypesOTCfgRemoteLogLevel 4The OTCfgRemoteLogLevel stru

Page 78 - OTCfgDuplicateEntity 3

CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Constants and Other Data Types 169OTCfgRemoteAnswerMode 4The OTCfgRemoteAnswerMode e

Page 79 - OTCfgGetEntityLogicalName 3

CHAPTER 1 About Network SetupNetwork Setup Database Fundamentals 17 one active set entity . The entities referenced by the active set entity compris

Page 80 - OTCfgGetEntityName 3

CHAPTER 4 Network Setup Protocol Structures and Data Types170 Protocol Constants and Other Data TypeskOTCfgNetProtoAT Allow AppleTalk connections (ATC

Page 81 - OTCfgSetEntityName 3

CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Constants and Other Data Types 171Constant descriptionskOTCfgModemGeneralPrefsThe pr

Page 82 - OTCfgChangeEntityArea 3

CHAPTER 4 Network Setup Protocol Structures and Data Types172 Protocol Constants and Other Data TypeskModemDialToneIgnore,kModemDialToneManual};Consta

Page 83 - Managing Preferences 3

CHAPTER 4Network Setup Protocol Structures and Data TypesProtocol Constants and Other Data Types 173enum {kOTCfgATalkGeneralPref = 'atpf',kO

Page 84 - OTCfgOpenPrefs 3

CHAPTER 4 Network Setup Protocol Structures and Data Types174 Protocol Constants and Other Data TypesOTCfgIRPortSetting 4The OTCfgIRPortSetting enumer

Page 85 - OTCfgGetPrefsSize 3

175GlossaryAARP See AppleTalk Address Resolution Protocol.Address Resolution Protocol (ARP) The Internet protocol that maps an IP address to a MAC ad

Page 86 - OTCfgGetPrefs 3

GLOSSARY176Datagram Delivery Protocol (DDP) The network-layer protocol that is responsible for the socket-to-socket delivery of datagrams over an Appl

Page 87 - OTCfgSetPrefs 3

GLOSSARY177media access control address The six-byte data link layer address that is required for every device that connects to a network. Other devic

Page 88 - OTCfgGetPrefsTOCCount 3

GLOSSARY178temporary area An area that is created when a named area is modified.Transmission Control Protocol/Internet Protocol A connection-oriented

Page 89 - OTCfgGetPrefsTOC 3

179IndexAactive set entityfinding 43–48number of 17, 43ARA constants 163architecture, Network Setup 11–14area IDscomparing 65set entities, working with

Page 90 - OTCfgDeletePrefs 3

CHAPTER 1 About Network Setup 18 Network Setup Database Fundamentals Figure 1-5 Sample organization of the default areaDefault areaAppleTalk global

Page 91 - OTCfgGetTemplate 3

INDEX180entitiesactive, finding 34active set 17changing 82classes 16classes and types 104closing 85counting 73creating 76deleting 43, 78duplicating 78g

Page 92 - Preference Utilities 3

INDEX181KkOTCfgClassNetworkConnection class 30kOTCfgSetsStructPref preference 43kOTCfgSetsVectorPref preference 43Llegacypreference files 13synchroniza

Page 93 - OTCfgDecrypt 3

INDEX182OTCfgIRGeneral structure 159OTCfgIsSameAreaID function 65OTCfgIsSameEntityRef function 76OTCfgModemApplication structure 141, 142OTCfgModemLoc

Page 94 - OTCfgInstallNotifier 3

INDEX183set entities 16active, number of 43using 42–49setting entity names 81structuresCfgEntityInfo 99CfgEntityRef 98, 99, 100CfgPrefsHeader 100, 101

Page 96 - Application-Defined Routines 3

CHAPTER 1 About Network SetupNetwork Setup Database Fundamentals 19 For simplicity, this example assumes a computer with two places of operation, hom

Page 97

 Apple Computer, Inc.© 2000 Apple Computer, Inc.All rights reserved. No part of this publication may be reproduced, stored in a retrieval system, or

Page 98 - CfgAreaID 3

CHAPTER 1 About Network Setup 20 Network Setup Database Fundamentals reading, it reads the area directly. Network Setup simply notes that the area i

Page 99 - CfgEntityInfo 3

CHAPTER 1 About Network SetupLegacy Issues 21 Preference Coherency 1When an application commits changes to the default area, it is important that app

Page 100 - CfgPrefsHeader 3

CHAPTER 1 About Network Setup22 Legacy IssuesGiven that legacy synchronization is slow and that legacy preferences files do not support multihoming, fu

Page 101 - CfgSetsStruct 3

CHAPTER 1About Network SetupNetwork Setup Version History 23entity, it creates a resource containing the preference data with the resource type matchi

Page 102 - Constant descriptions

CHAPTER 1 About Network Setup24 Network Setup Version History

Page 103 - CfgSetsVector 3

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

Page 104 - Network Setup Constants 3

CHAPTER 2 Using Network Setup26 Opening and Closing the Network Setup DatabaseListing 2-1 Opening the database for readingstatic OSStatus MyOpenDataba

Page 105 - Wildcard Classes and Types 3

CHAPTER 2Using Network SetupOpening and Closing the Network Setup Database 27area, but you can read from both the original area and the writable area

Page 106 - Common Preference Types 3

CHAPTER 2 Using Network Setup28 Opening and Closing the Network Setup DatabaseClosing the Database After Reading 2The MyCloseDatabaseAfterReading rout

Page 107 - Global Preference Types 3

CHAPTER 2Using Network SetupOpening and Closing the Network Setup Database 29If commit is false, the routine calls OTCfgAbortAreaModifications to disc

Page 108 - Set Entity Preference Types 3

3 Contents Figures, Tables, and Listings 7 Preface About This Manual 9Conventions Used in This Manual 9For More Information 10 Chapter 1 About Networ

Page 109 - Invalid Area ID 3

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

Page 110 - Result Codes 3

CHAPTER 2Using Network SetupWorking with Entities 31 Getting all entities. Set entityClass and entityType to the wildcard values kCfgClassAnyEntity a

Page 111 - Data Types 4

CHAPTER 2 Using Network Setup32 Working with EntitiesSetHandleSize( (Handle) entityRefs, entityCount * sizeof(CfgEntityRef) );err = MemError();} if

Page 112 - OTCfgTCPInterfacesUnpacked 4

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

Page 113 - Protocol Structures 113

CHAPTER 2 Using Network Setup34 Reading and Writing PreferencesentityCount = GetHandleSize( (Handle) entityRefs ) / sizeof(CfgEntityRef);for (entityIn

Page 114 - OTCfgTCPInterfacesPacked 4

CHAPTER 2Using Network SetupReading and Writing Preferences 35write the desired preferences, and close the entity. This section describes this process

Page 115 - OTCfgTCPDHCPLeaseInfo 4

CHAPTER 2 Using Network Setup36 Reading and Writing PreferencesNoteThe sample shown in Listing 2-7, which opens and closes the entity before reading e

Page 116 - OTCfgTCPLocks 4

CHAPTER 2Using Network SetupReading and Writing Preferences 37IMPORTANTYou can derive the C structure for a specific preference type by removing the “k

Page 117 - Protocol Structures 117

CHAPTER 2 Using Network Setup38 Reading and Writing Preferencesby calling OTCfgGetPrefsSize before you read the preference, as shown in Listing 2-10.L

Page 118 - Protocol Structures

CHAPTER 2Using Network SetupReading and Writing Preferences 39}return err;}Writing Preferences 2Listing 2-11 shows the routine MyWritePref, which demo

Page 119 - OTCfgTCPRoutersListEntry 4

4 Writing Preferences 39Iterating the Preferences in an Entity 40Working with Sets 42Finding the Active Set Entity 43Areas and Sets 48Protocol-specifi

Page 120 - OTCfgTCPSearchList 4

CHAPTER 2 Using Network Setup40 Reading and Writing Preferenceserr2 = OTCfgClosePrefs(accessID);if (err == noErr) {err = err2;}}return err;}NoteThe sa

Page 121 - OTCfgTCPUnloadAttr 4

CHAPTER 2Using Network SetupReading and Writing Preferences 41assert(dbRef != nil);assert(entity != nil);prefsTOC = nil;err = OTCfgOpenPrefs(dbRef, e

Page 122

CHAPTER 2 Using Network Setup42 Working with SetsWorking with Sets 2The Network Setup database uses set entities to store collections of other entity

Page 123 - OTCfgRemoteApplication 4

CHAPTER 2Using Network SetupWorking with Sets 43There are a few basic rules for set entities: Each set entity contains a preference, kOTCfgSetsStruct

Page 124 - OTCfgRemoteARAP 4

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

Page 125 - OTCfgRemoteClientLocks 4

CHAPTER 2Using Network SetupWorking with Sets 45kOTCfgSetsStructPref,&thisStruct, sizeof(thisStruct));if ((err == noErr) && ((thisStruct.f

Page 126

CHAPTER 2 Using Network Setup46 Working with SetsListing 2-14 Finding the active entity of a given class and typestatic OSStatus MyFindFirstActiveEnti

Page 127 - OTCfgRemoteConnect 4

CHAPTER 2Using Network SetupWorking with Sets 47*activeEntity = (**entitiesInSet).fElements[entityIndex].fEntityRef;OTCfgChangeEntityArea(activeEntity

Page 128

CHAPTER 2 Using Network Setup48 Working with Setsprintf("User-visible name of active TCP/IP entity = "%#s"\n", userVisibleName);}M

Page 129 - Protocol Structures 129

CHAPTER 2Using Network SetupProtocol-specific Topics 49The solution to this problem is very simple: assume that all entity references in a set refer to

Page 130 - OTCfgRemoteDialAssist 4

5 Chapter 4 Network Setup Protocol Structures and Data Types 111Protocol Structures 111TCP/IP Structures 111Apple Remote Access Structures 122Modem S

Page 131 - OTCfgRemoteDialing 4

CHAPTER 2 Using Network Setup50 Protocol-specific Topics kOTCfgTCPDNSServersListPref, which contains the list of configured DNS servers. For details, s

Page 132 - OTCfgRemoteIPCP 4

CHAPTER 2Using Network SetupProtocol-specific Topics 51cursor = (UInt8 *) packedPref;// For each field in the unpacked pref, copy the field to the// pa

Page 133 - OTCfgRemoteLCP 4

CHAPTER 2 Using Network Setup52 Protocol-specific Topicsstatic OSStatus MyUnpackTCPInterfacesPref(const OTCfgTCPInterfacesPacked *packedPref, ByteCount

Page 134

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

Page 135 - OTCfgRemotePassword 4

CHAPTER 2 Using Network Setup54 Protocol-specific Topics kOTCfgRemoteLogOptionsPref, which contains the “verbose logging” option. For details, see OTC

Page 136 - OTCfgRemoteServer 4

CHAPTER 2Using Network SetupNotes for Third Parties 55DTS Technote 1119 Serial Port Apocrypha available at http://developer.apple.com/technotes/tn/tn1

Page 137 - OTCfgRemoteServerPort 4

CHAPTER 2 Using Network Setup56 Notes for Third Parties

Page 138 - OTCfgRemoteTerminal 4

Network Setup Functions 57CHAPTER 3Network Setup Reference 3Figure 3-0Listing 3-0Table 3-0This chapter describes the functions, structures, and data t

Page 139 - OTCfgRemoteUserMode 4

CHAPTER 3 Network Setup Reference58 Network Setup FunctionsOTCfgOpenDatabase 3Opens a session with the Network Setup database.OSStatus OTCfgOpenDataba

Page 140

CHAPTER 3Network Setup ReferenceNetwork Setup Functions 59NoteClosing a database session automatically removes any notification callback that has been

Page 142 - OTCfgModemApplication 4

CHAPTER 3 Network Setup Reference60 Network Setup FunctionsIMPORTANTAreas other than the default area (also known as the current area) do not affect a

Page 143 - OTCfgModemLocks 4

CHAPTER 3Network Setup ReferenceNetwork Setup Functions 61OTCfgSetCurrentArea 3Sets the default area.OSStatus OTCfgSetCurrentArea (CfgDatabaseRef dbRe

Page 144 - AppleTalk Structures 4

CHAPTER 3 Network Setup Reference62 Network Setup FunctionsdbRef On input, a value of type CfgDatabaseRef (page 98) that represents a database session

Page 145 - OTCfgATalkGeneral 4

CHAPTER 3Network Setup ReferenceNetwork Setup Functions 63OTCfgBeginAreaModifications 3Creates a temporary area for modifying an area.OSStatus OTCfgBeg

Page 146 - OTCfgATalkGeneralAARP 4

CHAPTER 3 Network Setup Reference64 Network Setup FunctionsCall OTCfgCommitAreaModifications (page 64) to write the temporary area to the area identifi

Page 147 - OTCfgATalkGeneralADSP 4

CHAPTER 3Network Setup ReferenceNetwork Setup Functions 65OTCfgAbortAreaModifications 3Closes an area for writing without committing modifications.OSSta

Page 148

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

Page 149 - OTCfgATalkGeneralASP 4

CHAPTER 3Network Setup ReferenceNetwork Setup Functions 67OTCfgSetAreaName 3Sets the user-visible name of an area.OSStatus OTCfgSetAreaName (CfgDataba

Page 150 - OTCfgATalkGeneralATP 4

CHAPTER 3 Network Setup Reference68 Network Setup FunctionsOTCfgGetAreasCount 3Obtains the number of areas in the Network Setup database.OSStatus OTCf

Page 151 - OTCfgATalkGeneralDDP 4

CHAPTER 3Network Setup ReferenceNetwork Setup Functions 69that are available. On output, itemCount points to the number of areas for which information

Page 152

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

Page 153 - OTCfgATalkGeneralNBP 4

CHAPTER 3 Network Setup Reference70 Network Setup FunctionsOTCfgCreateArea 3Creates an area in the Network Setup database.OSStatus OTCfgCreateArea (Cf

Page 154 - OTCfgATalkGeneralPAP 4

CHAPTER 3Network Setup ReferenceNetwork Setup Functions 71OTCfgDuplicateArea 3Copies the contents of one area to another area.OSStatus OTCfgDuplicateA

Page 155 - OTCfgATalkGeneralZIP 4

CHAPTER 3 Network Setup Reference72 Network Setup FunctionsOTCfgDeleteArea 3Deletes an area in the Network Setup database.OSStatus OTCfgDeleteArea (Cf

Page 156 - OTCfgATalkLocks 4

CHAPTER 3Network Setup ReferenceNetwork Setup Functions 73 OTCfgDuplicateEntity (page 78) copies the contents of one entity to another entity. OTCfg

Page 157 - Protocol Structures 157

CHAPTER 3 Network Setup Reference74 Network Setup FunctionsitemCount On input, a pointer to a value of type ItemCount. On output, itemCount contains t

Page 158 - Infrared Structures 4

CHAPTER 3Network Setup ReferenceNetwork Setup Functions 75entityType On input, a value of type CfgEntityType that specifies the type that is to be matc

Page 159 - OTCfgIRGeneral 4

CHAPTER 3 Network Setup Reference76 Network Setup FunctionsOTCfgIsSameEntityRef 3Compares two entity references.Boolean OTCfgIsSameEntityRef (const Cf

Page 160

CHAPTER 3Network Setup ReferenceNetwork Setup Functions 77dbRef On input, a value of type CfgDatabaseRef (page 98) that represents a database session

Page 161 - CHAPTER 4

CHAPTER 3 Network Setup Reference78 Network Setup FunctionsOTCfgDeleteEntity 3Deletes the specified entity.OSStatus OTCfgDeleteEntity (CfgDatabaseRef d

Page 162

CHAPTER 3Network Setup ReferenceNetwork Setup Functions 79entityRef On input, a pointer to a value of type CfgEntityRef (page 99) that identifies the e

Page 164

CHAPTER 3 Network Setup Reference80 Network Setup Functionsfunction result A value of noErr indicates that OTCfgGetEntityLogicalName returned successf

Page 165

CHAPTER 3Network Setup ReferenceNetwork Setup Functions 81▲WARNINGThe OTCfgGetEntityName function does not return the user-visible name of the entity.

Page 166

CHAPTER 3 Network Setup Reference82 Network Setup FunctionsDISCUSSIONThe OTCfgSetEntityName function sets the user-visible name of the specified entity

Page 167 - OTCfgRemoteProtocol 4

CHAPTER 3Network Setup ReferenceNetwork Setup Functions 83entityRef On input, a pointer to a value of type CfgEntityRef (page 99) that represents the

Page 168 - OTCfgRemoteDialMode 4

CHAPTER 3 Network Setup Reference84 Network Setup FunctionsOTCfgOpenPrefs 3Opens an entity so that its preferences can be accessed.OSStatus OTCCfgOpen

Page 169 - OTCfgRemoteNetworkProtocol 4

CHAPTER 3Network Setup ReferenceNetwork Setup Functions 85OTCfgClosePrefs 3Closes an entity.OSStatus OTCCfgClosePrefs (CfgEntityAccessID accessID);acc

Page 170 - OTCfgRemoteNetAccessMode 4

CHAPTER 3 Network Setup Reference86 Network Setup Functionsfunction result A value of noErr indicates that OTCfgGetPrefsSize returned successfully. Fo

Page 171 - OTCfgModemDialingToneMode 4

CHAPTER 3Network Setup ReferenceNetwork Setup Functions 87DISCUSSIONThe OTCfgGetPrefs function gets the value of the preference specified by prefsType

Page 172

CHAPTER 3 Network Setup Reference88 Network Setup FunctionsDISCUSSIONThe OTCfgSetPrefs function sets the preference represented by prefsType to the va

Page 173

CHAPTER 3Network Setup ReferenceNetwork Setup Functions 89OTCfgGetPrefsTOC 3Gets a list of the preferences in an entity.OSStatus OTCfgGetPrefsTOC (Cfg

Page 174 - OTCfgIRPortSetting 4

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

Page 175 - Glossary

CHAPTER 3 Network Setup Reference90 Network Setup FunctionsOTCfgGetDefault 3Returns a handle containing the default value for a preference.Handle OTCf

Page 176 - GLOSSARY

CHAPTER 3Network Setup ReferenceNetwork Setup Functions 91accessID On input, a value of type CfgEntityAccessID (page 100), obtained by previously call

Page 177

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

Page 178

CHAPTER 3Network Setup ReferenceNetwork Setup Functions 93OTCfgEncrypt 3Encrypts data.SInt16 OTCCfgEncrypt (const UInt8 *key.UInt8 *data,SInt16 dataLe

Page 179

CHAPTER 3 Network Setup Reference94 Network Setup Functionskey On input, a pointer to a Pascal string containing the encryption key. Usually the encry

Page 180

CHAPTER 3Network Setup ReferenceNetwork Setup Functions 95dbRef On input, a value of type CfgDatabaseRef (page 98) that represents a database session

Page 181

CHAPTER 3 Network Setup Reference96 Network Setup FunctionsOTCfgRemoveNotifier 3Removes a notification callback.OSStatus OTCfgRemoveNotifier (CfgDatabas

Page 182

CHAPTER 3Network Setup ReferenceNetwork Setup Structures and Data Types 97Notification Callback Routine 3Receives notifications of changes to the Networ

Page 183

CHAPTER 3 Network Setup Reference98 Network Setup Structures and Data Types CfgEntityInfo (page 99), which contains information about the entities in

Page 184

CHAPTER 3Network Setup ReferenceNetwork Setup Structures and Data Types 99Network Setup uses a value of type CfgAreaID to identify the area in which a

Commentaires sur ces manuels

Pas de commentaire