Apple Network Setup Uživatelský manuál

Procházejte online nebo si stáhněte Uživatelský manuál pro Hardware Apple Network Setup. Apple Network Setup User Manual Uživatelská příručka

  • Stažení
  • Přidat do mých příruček
  • Tisk
  • Strana
    / 184
  • Tabulka s obsahem
  • KNIHY
  • Hodnocené. / 5. Na základě hodnocení zákazníků

Shrnutí obsahu

Strany 1 - Network Setup

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

Strany 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

Strany 3 - Contents

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

Strany 4

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

Strany 5 - Chapter 4

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

Strany 6

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

Strany 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

Strany 8

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

Strany 9 - About This Manual

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

Strany 10 - For More Information 0

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

Strany 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

Strany 12

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

Strany 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

Strany 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

Strany 15

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

Strany 16 - Database Structure 1

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

Strany 17 - Database Structure Example 1

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

Strany 18

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

Strany 19 - Database Operations 1

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

Strany 20

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

Strany 21

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

Strany 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

Strany 23

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

Strany 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

Strany 25 - Using Network Setup 2

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

Strany 26 - Using Network Setup

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

Strany 27

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

Strany 28

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

Strany 29

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

Strany 30 - Working with Entities 2

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

Strany 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

Strany 32 - 32 Working with Entities

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

Strany 33 - Working with Entities 33

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

Strany 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

Strany 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

Strany 36

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

Strany 37

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

Strany 38 - Listing 2-10

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

Strany 39 - Writing Preferences 2

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

Strany 40

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

Strany 41

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

Strany 42 - Working with Sets 2

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

Strany 43 - Working with Sets 43

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

Strany 44 - Working with Sets

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

Strany 45 - Working with Sets 45

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

Strany 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

Strany 47 - Working with Sets 47

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

Strany 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

Strany 49 - Protocol-specific Topics 2

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

Strany 50 - Protocol-specific Topics

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

Strany 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

Strany 52 - 52 Protocol-specific Topics

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

Strany 53 - Remote Access Notes 2

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

Strany 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

Strany 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

Strany 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

Strany 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

Strany 58 - OTCfgCloseDatabase 3

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

Strany 59 - Managing Areas 3

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

Strany 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

Strany 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

Strany 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

Strany 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

Strany 64 - OTCfgCommitAreaModifications 3

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

Strany 65 - OTCfgIsSameAreaID 3

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

Strany 66 - OTCfgGetAreaName 3

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

Strany 67 - OTCfgSetAreaName 3

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

Strany 68 - OTCfgGetAreasList 3

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

Strany 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

Strany 70 - OTCfgCreateArea 3

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

Strany 71 - OTCfgDuplicateArea 3

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

Strany 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

Strany 73 - OTCfgGetEntitiesCount 3

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

Strany 74 - OTCfgGetEntitiesList 3

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

Strany 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

Strany 76 - OTCfgCreateEntity 3

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

Strany 77 - Network Setup Functions 77

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

Strany 78 - OTCfgDuplicateEntity 3

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

Strany 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

Strany 80 - OTCfgGetEntityName 3

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

Strany 81 - OTCfgSetEntityName 3

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

Strany 82 - OTCfgChangeEntityArea 3

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

Strany 83 - Managing Preferences 3

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

Strany 84 - OTCfgOpenPrefs 3

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

Strany 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

Strany 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

Strany 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

Strany 88 - OTCfgGetPrefsTOCCount 3

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

Strany 89 - OTCfgGetPrefsTOC 3

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

Strany 90 - OTCfgDeletePrefs 3

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

Strany 91 - OTCfgGetTemplate 3

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

Strany 92 - Preference Utilities 3

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

Strany 93 - OTCfgDecrypt 3

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

Strany 94 - OTCfgInstallNotifier 3

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

Strany 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

Strany 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

Strany 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

Strany 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

Strany 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

Strany 101 - CfgSetsStruct 3

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

Strany 102 - Constant descriptions

CHAPTER 1 About Network Setup24 Network Setup Version History

Strany 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

Strany 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

Strany 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

Strany 106 - Common Preference Types 3

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

Strany 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

Strany 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

Strany 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

Strany 110 - Result Codes 3

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

Strany 111 - Data Types 4

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

Strany 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

Strany 113 - Protocol Structures 113

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

Strany 114 - OTCfgTCPInterfacesPacked 4

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

Strany 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

Strany 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

Strany 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

Strany 118 - Protocol Structures

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

Strany 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

Strany 120 - OTCfgTCPSearchList 4

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

Strany 121 - OTCfgTCPUnloadAttr 4

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

Strany 122

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

Strany 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

Strany 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

Strany 125 - OTCfgRemoteClientLocks 4

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

Strany 126

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

Strany 127 - OTCfgRemoteConnect 4

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

Strany 128

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

Strany 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

Strany 130 - OTCfgRemoteDialAssist 4

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

Strany 131 - OTCfgRemoteDialing 4

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

Strany 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

Strany 133 - OTCfgRemoteLCP 4

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

Strany 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

Strany 135 - OTCfgRemotePassword 4

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

Strany 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

Strany 137 - OTCfgRemoteServerPort 4

CHAPTER 2 Using Network Setup56 Notes for Third Parties

Strany 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

Strany 139 - OTCfgRemoteUserMode 4

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

Strany 140

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

Strany 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

Strany 143 - OTCfgModemLocks 4

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

Strany 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

Strany 145 - OTCfgATalkGeneral 4

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

Strany 146 - OTCfgATalkGeneralAARP 4

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

Strany 147 - OTCfgATalkGeneralADSP 4

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

Strany 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

Strany 149 - OTCfgATalkGeneralASP 4

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

Strany 150 - OTCfgATalkGeneralATP 4

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

Strany 151 - OTCfgATalkGeneralDDP 4

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

Strany 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

Strany 153 - OTCfgATalkGeneralNBP 4

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

Strany 154 - OTCfgATalkGeneralPAP 4

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

Strany 155 - OTCfgATalkGeneralZIP 4

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

Strany 156 - OTCfgATalkLocks 4

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

Strany 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

Strany 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

Strany 159 - OTCfgIRGeneral 4

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

Strany 160

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

Strany 161 - CHAPTER 4

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

Strany 162

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

Strany 164

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

Strany 165

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

Strany 166

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

Strany 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

Strany 168 - OTCfgRemoteDialMode 4

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

Strany 169 - OTCfgRemoteNetworkProtocol 4

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

Strany 170 - OTCfgRemoteNetAccessMode 4

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

Strany 171 - OTCfgModemDialingToneMode 4

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

Strany 172

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

Strany 173

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

Strany 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

Strany 175 - Glossary

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

Strany 176 - GLOSSARY

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

Strany 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

Strany 178

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

Strany 179

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

Strany 180

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

Strany 181

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

Strany 182

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

Strany 183

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

Strany 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

Komentáře k této Příručce

Žádné komentáře