-
Notifications
You must be signed in to change notification settings - Fork 3
/
listing47.html
executable file
·839 lines (723 loc) · 30.6 KB
/
listing47.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
<html>
<head>
<!-- BEGIN META TAG INFO -->
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<link rel="home" href="http://developer.apple.com/">
<link rel="find" href="http://developer.apple.com/search/">
<link rel="stylesheet" type="text/css" href="../../documentation/css/adcstyle.css" title="fonts">
<script language="JavaScript" src="../../documentation/js/adc.js" type="text/javascript"></script>
<!-- END META TAG INFO -->
<!-- BEGIN TITLE -->
<title>QISA - /MoreIsBetter Bits/MoreIsBetter/MIB-Libraries/NetworkSetup/MoreNetworkSetup.c</title>
<!-- END TITLE -->
<script language="JavaScript">
function JumpToNewPage() {
window.location=document.scpopupmenu.gotop.value;
return true;
}
</script>
</head>
<!-- BEGIN BODY OPEN -->
<body>
<!--END BODY OPEN -->
<!-- START CENTER OPEN -->
<center>
<!-- END CENTER OPEN -->
<!-- BEGIN LOGO AND SEARCH -->
<!--#include virtual="/includes/adcnavbar"-->
<!-- END LOGO AND SEARCH -->
<!-- START BREADCRUMB -->
<div id="breadcrumb">
<table width="680" border="0" cellpadding="0" cellspacing="0">
<tr>
<td scope="row"><img width="340" height="10" src="images/1dot.gif" alt=""></td>
<td><img width="340" height="10" src="images/1dot.gif" alt=""></td>
</tr>
<tr valign="middle">
<td align="left" colspan="2">
<a href="http://developer.apple.com/">ADC Home</a> > <a href="../../referencelibrary/index.html">Reference Library</a> > <a href="../../samplecode/index.html">Sample Code</a> > <a href="../../samplecode/Networking/index.html">Networking</a> > <a href="../../samplecode/Networking/idxDarwin-date.html">Darwin</a> > <A HREF="javascript:location.replace('index.html');">QISA</A> >
</td>
</tr>
<tr>
<td colspan="2" scope="row"><img width="680" height="35" src="images/1dot.gif" alt=""></td>
</tr>
</table>
</div>
<!-- END BREADCRUMB -->
<!-- START MAIN CONTENT -->
<!-- START TITLE GRAPHIC AND INTRO-->
<table width="680" border="0" cellpadding="0" cellspacing="0">
<tr align="left" valign="top">
<td><h1><div id="pagehead">QISA</div></h1></td>
</tr>
</table>
<!-- END TITLE GRAPHIC AND INTRO -->
<!-- START WIDE COLUMN -->
<table width="680" border="0" cellpadding="0" cellspacing="0">
<tr align="left" valign="top">
<td id="scdetails">
<h2>/MoreIsBetter Bits/MoreIsBetter/MIB-Libraries/NetworkSetup/MoreNetworkSetup.c</h2>
<form name="scpopupmenu" onSubmit="return false;" method=post>
<p><strong>View Source Code:</strong>
<select name="gotop" onChange="JumpToNewPage();" style="width:340px"><option selected value="ingnore">Select File</option>
<option value="listing1.html">/MoreIsBetter Bits/MoreIsBetter/MIB-Libraries/MoreAppearance/MoreAppearance.cp</option>
<option value="listing2.html">/MoreIsBetter Bits/MoreIsBetter/MIB-Libraries/MoreAppearance/MoreAppearance.h</option>
<option value="listing3.html">/MoreIsBetter Bits/MoreIsBetter/MIB-Libraries/MoreAppleEvents/MoreAEDataModel.c</option>
<option value="listing4.html">/MoreIsBetter Bits/MoreIsBetter/MIB-Libraries/MoreAppleEvents/MoreAEDataModel.h</option>
<option value="listing5.html">/MoreIsBetter Bits/MoreIsBetter/MIB-Libraries/MoreAppleEvents/MoreAEObjects.c</option>
<option value="listing6.html">/MoreIsBetter Bits/MoreIsBetter/MIB-Libraries/MoreAppleEvents/MoreAEObjects.h</option>
<option value="listing7.html">/MoreIsBetter Bits/MoreIsBetter/MIB-Libraries/MoreAppleEvents/MoreAppleEvents.cp</option>
<option value="listing8.html">/MoreIsBetter Bits/MoreIsBetter/MIB-Libraries/MoreAppleEvents/MoreAppleEvents.h</option>
<option value="listing9.html">/MoreIsBetter Bits/MoreIsBetter/MIB-Libraries/MoreCarbonEvents/MoreCarbonEvents.c</option>
<option value="listing10.html">/MoreIsBetter Bits/MoreIsBetter/MIB-Libraries/MoreCarbonEvents/MoreCarbonEvents.h</option>
<option value="listing11.html">/MoreIsBetter Bits/MoreIsBetter/MIB-Libraries/MoreCFQ/MoreCFQ.c</option>
<option value="listing12.html">/MoreIsBetter Bits/MoreIsBetter/MIB-Libraries/MoreCFQ/MoreCFQ.h</option>
<option value="listing13.html">/MoreIsBetter Bits/MoreIsBetter/MIB-Libraries/MoreControls/MoreControls.cp</option>
<option value="listing14.html">/MoreIsBetter Bits/MoreIsBetter/MIB-Libraries/MoreControls/MoreControls.h</option>
<option value="listing15.html">/MoreIsBetter Bits/MoreIsBetter/MIB-Libraries/MoreDialogs/MoreDialogs.cp</option>
<option value="listing16.html">/MoreIsBetter Bits/MoreIsBetter/MIB-Libraries/MoreDialogs/MoreDialogs.h</option>
<option value="listing17.html">/MoreIsBetter Bits/MoreIsBetter/MIB-Libraries/MoreInterfaceLib/MoreInterfaceLib.c</option>
<option value="listing18.html">/MoreIsBetter Bits/MoreIsBetter/MIB-Libraries/MoreInterfaceLib/MoreInterfaceLib.h</option>
<option value="listing19.html">/MoreIsBetter Bits/MoreIsBetter/MIB-Libraries/MoreInterfaceLib/RemoteAccessInterface.h</option>
<option value="listing20.html">/MoreIsBetter Bits/MoreIsBetter/MIB-Libraries/MoreMemory/MoreMemory.c</option>
<option value="listing21.html">/MoreIsBetter Bits/MoreIsBetter/MIB-Libraries/MoreMemory/MoreMemory.h</option>
<option value="listing22.html">/MoreIsBetter Bits/MoreIsBetter/MIB-Libraries/MoreOSUtils/MoreOSUtils.c</option>
<option value="listing23.html">/MoreIsBetter Bits/MoreIsBetter/MIB-Libraries/MoreOSUtils/MoreOSUtils.h</option>
<option value="listing24.html">/MoreIsBetter Bits/MoreIsBetter/MIB-Libraries/MoreProcesses/MoreProcesses.cp</option>
<option value="listing25.html">/MoreIsBetter Bits/MoreIsBetter/MIB-Libraries/MoreProcesses/MoreProcesses.h</option>
<option value="listing26.html">/MoreIsBetter Bits/MoreIsBetter/MIB-Libraries/MoreQuickDraw/MoreQuickDraw.cp</option>
<option value="listing27.html">/MoreIsBetter Bits/MoreIsBetter/MIB-Libraries/MoreQuickDraw/MoreQuickDraw.h</option>
<option value="listing28.html">/MoreIsBetter Bits/MoreIsBetter/MIB-Libraries/MoreSCF/MoreSCF.c</option>
<option value="listing29.html">/MoreIsBetter Bits/MoreIsBetter/MIB-Libraries/MoreSCF/MoreSCF.h</option>
<option value="listing30.html">/MoreIsBetter Bits/MoreIsBetter/MIB-Libraries/MoreSCF/MoreSCFCCLScanner.c</option>
<option value="listing31.html">/MoreIsBetter Bits/MoreIsBetter/MIB-Libraries/MoreSCF/MoreSCFCCLScanner.h</option>
<option value="listing32.html">/MoreIsBetter Bits/MoreIsBetter/MIB-Libraries/MoreSCF/MoreSCFDigest.c</option>
<option value="listing33.html">/MoreIsBetter Bits/MoreIsBetter/MIB-Libraries/MoreSCF/MoreSCFDigest.h</option>
<option value="listing34.html">/MoreIsBetter Bits/MoreIsBetter/MIB-Libraries/MoreSCF/MoreSCFHelpers.c</option>
<option value="listing35.html">/MoreIsBetter Bits/MoreIsBetter/MIB-Libraries/MoreSCF/MoreSCFHelpers.h</option>
<option value="listing36.html">/MoreIsBetter Bits/MoreIsBetter/MIB-Libraries/MoreSCF/MoreSCFPortScanner.c</option>
<option value="listing37.html">/MoreIsBetter Bits/MoreIsBetter/MIB-Libraries/MoreSCF/MoreSCFPortScanner.h</option>
<option value="listing38.html">/MoreIsBetter Bits/MoreIsBetter/MIB-Libraries/MoreSecurity/MoreSecurity.c</option>
<option value="listing39.html">/MoreIsBetter Bits/MoreIsBetter/MIB-Libraries/MoreSecurity/MoreSecurity.h</option>
<option value="listing40.html">/MoreIsBetter Bits/MoreIsBetter/MIB-Libraries/MoreSetup.h</option>
<option value="listing41.html">/MoreIsBetter Bits/MoreIsBetter/MIB-Libraries/MoreTextUtils/MoreTextUtils.cp</option>
<option value="listing42.html">/MoreIsBetter Bits/MoreIsBetter/MIB-Libraries/MoreTextUtils/MoreTextUtils.h</option>
<option value="listing43.html">/MoreIsBetter Bits/MoreIsBetter/MIB-Libraries/MoreUNIX/MoreUNIX.c</option>
<option value="listing44.html">/MoreIsBetter Bits/MoreIsBetter/MIB-Libraries/MoreUNIX/MoreUNIX.h</option>
<option value="listing45.html">/MoreIsBetter Bits/MoreIsBetter/MIB-Libraries/MoreWindows/MoreWindows.cp</option>
<option value="listing46.html">/MoreIsBetter Bits/MoreIsBetter/MIB-Libraries/MoreWindows/MoreWindows.h</option>
<option value="listing47.html">/MoreIsBetter Bits/MoreIsBetter/MIB-Libraries/NetworkSetup/MoreNetworkSetup.c</option>
<option value="listing48.html">/MoreIsBetter Bits/MoreIsBetter/MIB-Libraries/NetworkSetup/MoreNetworkSetup.h</option>
<option value="listing49.html">/MoreIsBetter Bits/MoreIsBetter/MIB-Libraries/NetworkSetup/NetworkSetupHelpers.c</option>
<option value="listing50.html">/MoreIsBetter Bits/MoreIsBetter/MIB-Libraries/NetworkSetup/NetworkSetupHelpers.h</option>
<option value="listing51.html">/MoreIsBetter Bits/MoreIsBetter/MIB-Libraries/NetworkSetup/OldStyleAPI/OldOTConfigLib.h</option>
<option value="listing52.html">/QISA.c</option>
<option value="listing53.html">/QISA.h</option>
<option value="listing54.html">/QISAPanels.c</option>
<option value="listing55.html">/QISAPanels.h</option>
<option value="listing56.html">/QISAPlatform.c</option>
<option value="listing57.html">/QISAPlatform.h</option>
<option value="listing58.html">/QISAPlatformCFM/QISAPlatformCFM.c</option>
<option value="listing59.html">/QISAPlatformCFM/QISAPlatformCFMPrefix.h</option>
<option value="listing60.html">/QISAPlatformMach-O/QISAPlatformMach-O.c</option>
<option value="listing61.html">/QISAPlatformMach-O/QISASetupTool.c</option>
<option value="listing62.html">/ReadMeAboutQISA.html</option></select>
</p>
</form>
<p><strong><a href="QISA.zip">Download Sample</a></strong> (“QISA.zip”, 610.6K)<BR>
<strong><a href="QISA.dmg">Download Sample</a></strong> (“QISA.dmg”, 903.9K)</p>
<!--
<p><strong><a href="#">Download Sample</a></strong> (“filename.sit”, 500K)</p>
-->
</td>
</tr>
<tr>
<td scope="row"><img width="680" height="10" src="images/1dot.gif" alt=""><br>
<img height="1" width="680" src="images/1dot_919699.gif" alt=""><br>
<img width="680" height="20" src="images/1dot.gif" alt=""></td>
</tr>
<tr>
<td scope="row">
<!--googleon: index -->
<pre class="sourcecodebox">/* File: MoreNetworkSetup.c Contains: Simple wrappers to make Network Setup easier. Written by: Quinn Copyright: Copyright (c) 1998-2001 by Apple Computer, Inc., All Rights Reserved. Disclaimer: IMPORTANT: This Apple software is supplied to you by Apple Computer, Inc. ("Apple") in consideration of your agreement to the following terms, and your use, installation, modification or redistribution of this Apple software constitutes acceptance of these terms. If you do not agree with these terms, please do not use, install, modify or redistribute this Apple software. In consideration of your agreement to abide by the following terms, and subject to these terms, Apple grants you a personal, non-exclusive license, under Apple's copyrights in this original Apple software (the "Apple Software"), to use, reproduce, modify and redistribute the Apple Software, with or without modifications, in source and/or binary forms; provided that if you redistribute the Apple Software in its entirety and without modifications, you must retain this notice and the following text and disclaimers in all such redistributions of the Apple Software. Neither the name, trademarks, service marks or logos of Apple Computer, Inc. may be used to endorse or promote products derived from the Apple Software without specific prior written permission from Apple. Except as expressly stated in this notice, no other rights or licenses, express or implied, are granted by Apple herein, including but not limited to any patent rights that may be infringed by your derivative works or by other works in which the Apple Software may be incorporated. The Apple Software is provided by Apple on an "AS IS" basis. APPLE MAKES NO WARRANTIES, EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, REGARDING THE APPLE SOFTWARE OR ITS USE AND OPERATION ALONE OR IN COMBINATION WITH YOUR PRODUCTS. IN NO EVENT SHALL APPLE BE LIABLE FOR ANY SPECIAL, INDIRECT, INCIDENTAL OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) ARISING IN ANY WAY OUT OF THE USE, REPRODUCTION, MODIFICATION AND/OR DISTRIBUTION OF THE APPLE SOFTWARE, HOWEVER CAUSED AND WHETHER UNDER THEORY OF CONTRACT, TORT (INCLUDING NEGLIGENCE), STRICT LIABILITY OR OTHERWISE, EVEN IF APPLE HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. Change History (most recent first):$Log: MoreNetworkSetup.c,v $Revision 1.21 2002/11/25 16:55:56 eskimo1Eliminate implicit arithmetic conversion warnings.Revision 1.20 2002/11/09 00:18:49 eskimo1Include our prototype early to flush out any missing dependencies. Convert nil to NULL. Convert MoreAssertQ to assert.Revision 1.19 2001/11/07 15:53:32 eskimo1Tidy up headers, add CVS logs, update copyright. <18> 21/9/01 Quinn Changes for CWPro7 Mach-O build. <17> 8/2/01 Quinn Quieten a bogus assert. <16> 24/11/00 Quinn Complain if compiled for Carbon. <15> 22/11/00 Quinn Switch to "MacTypes.h". Also switch to "MacErrors.h". <14> 22/11/00 Quinn CWPro6 is more picky about pointer type compatibility. Add some casts. <13> 11/4/00 Quinn In MNSSetPref, check prefSize against 0, not nil. <12> 17/1/00 Quinn Updates for latest Network Setup headers. <11> 19/10/99 Quinn Fix embarrassing spelling error. <10> 16/9/99 Quinn MNGetPrefHandle was always returning an error. Thanks to Thomas Weisbach. <9> 31/8/99 AndyB MNSGetEntitiesList could lose MemError when allocating paramInfos. <8> 21/4/99 Quinn Added MNSGetPrefHandle, MNSSetPrefHandle and MNSIterateEntity, along with some general tidy up. <7> 30/3/99 Quinn Fixed type check error when calling DisposePtr. <6> 10/11/98 Quinn Fix bug in MNSIterateSet where it incremented the loop counter twice each iteration. Whoops. <5> 10/11/98 Quinn Convert "MorePrefix.h" to "MoreSetup.h". <4> 5/11/98 Quinn Use MoreAssertQ instead of MoreAssert. <3> 5/11/98 Quinn Fix header again. <2> 5/11/98 Quinn Fix header. <1> 5/11/98 Quinn First checked in.*//////////////////////////////////////////////////////////////////// Our Prototypes#include "MoreNetworkSetup.h"#if TARGET_API_MAC_CARBON // The Network Setup API is not part of Carbon, and hence this module // does not support Carbon development. If you have a Carbon // application, you need to use the Network Setup API on traditional Mac OS // and System Configuration framework on Mac OS X. #error MoreNetworkSetup does not support Carbon development.#endif// Mac OS Interfaces#if ! MORE_FRAMEWORK_INCLUDES #include <MacTypes.h> #include <Files.h> #include <MacErrors.h> #include <Folders.h> #include <Resources.h> #include <Gestalt.h> #include <CodeFragments.h> #include <NetworkSetup.h>#endif/////////////////////////////////////////////////////////////////#if TARGET_RT_MAC_CFM extern pascal Boolean IsNetworkSetupAvailable() // See comment in interface part. { return (void *) OTCfgOpenDatabase != (void *) kUnresolvedCFragSymbolAddress; }#else extern pascal Boolean IsNetworkSetupAvailable() // See comment in interface part. { OSStatus junk; Boolean result; UInt32 response; CFragConnectionID connID; Ptr junkMain; Str255 junkMessage; #if TARGET_RT_MAC_CFM #error "IsNetworkSetupAvailable: This routine should not be used by CFM code." #endif result = false; if ( Gestalt(gestaltCFMAttr, (SInt32 *) &response) == noErr && (response & (1 << gestaltCFMPresent)) != 0) { if ( GetSharedLibrary("\pCfgOpenTpt", kAnyCFragArch, kReferenceCFrag, &connID, &junkMain, junkMessage) == noErr ) { result = true; junk = CloseConnection(&connID); assert(junk == noErr); } } return result; }#endifextern pascal Boolean MNSValidDatabase(const MNSDatabaseRef *ref) // See comment in interface part.{ return ref != NULL && ref->dbRef != NULL && ref->area != 0;}extern pascal Boolean MNSDatabaseWritable(const MNSDatabaseRef *ref) // See comment in interface part.{ return (ref->originalArea != 0);}extern pascal OSStatus MNSOpenDatabase(MNSDatabaseRef *ref, Boolean forWriting) // See comment in interface part.{ OSStatus err; OSStatus junk; assert(ref != NULL); ref->dbRef = NULL; ref->area = 0; ref->originalArea = 0; err = OTCfgOpenDatabase(&ref->dbRef); if (err == noErr) { err = OTCfgGetCurrentArea(ref->dbRef, &ref->area); if (err == noErr) { if (forWriting) { ref->originalArea = ref->area; err = OTCfgBeginAreaModifications(ref->dbRef, ref->originalArea, &ref->area); } else { err = OTCfgOpenArea(ref->dbRef, ref->area); } } if (err != noErr) { junk = MNSCloseDatabase(ref, false); assert(junk == noErr); } } return err; }extern pascal OSStatus MNSCloseDatabase(MNSDatabaseRef *ref, Boolean commit) // See comment in interface part.{ OSStatus err; OSStatus err2; assert(ref != NULL); assert(ref->dbRef != NULL); assert(ref->originalArea == 0 || ref->area != 0); err = noErr; if (ref->area != 0) { if ( MNSDatabaseWritable(ref) ) { if ( commit ) { err = OTCfgCommitAreaModifications(ref->dbRef, ref->originalArea, ref->area); } else { err = OTCfgAbortAreaModifications(ref->dbRef, ref->originalArea); } } else { // Database was opened read-only, you're just not allowed to commit it. assert( ! commit ); err = OTCfgCloseArea(ref->dbRef, ref->area); } } err2 = OTCfgCloseDatabase(&ref->dbRef); if (err == noErr) { err = err2; } ref->dbRef = NULL; ref->area = 0; ref->originalArea = 0; return err;}extern pascal OSStatus MNSGetFixedSizePref(const MNSDatabaseRef *ref, const CfgEntityRef *entityID, OSType prefType, void *buffer, ByteCount prefSize) // See comment in interface part.{ OSStatus err; OSStatus err2; CfgEntityAccessID prefsRefNum; ByteCount actualPrefSize; assert(MNSValidDatabase(ref)); assert(entityID != NULL); assert(buffer != NULL); // Open the entity, read out the preference, and then // close it down. err = OTCfgOpenPrefs(ref->dbRef, entityID, false, &prefsRefNum); if (err == noErr) { err = OTCfgGetPrefsSize(prefsRefNum, prefType, &actualPrefSize); if (err == noErr && actualPrefSize != prefSize) { err = -1; } if (err == noErr) { err = OTCfgGetPrefs(prefsRefNum, prefType, buffer, prefSize); } err2 = OTCfgClosePrefs(prefsRefNum); if (err == noErr) { err = err2; } } return err;}extern pascal OSStatus MNSGetPref(const MNSDatabaseRef *ref, const CfgEntityRef *entityID, OSType prefType, void **buffer, ByteCount *prefSize) // See comment in interface part.{ OSStatus err; OSStatus err2; CfgEntityAccessID prefsRefNum; ByteCount junkPrefSize; assert(MNSValidDatabase(ref)); assert(entityID != NULL); assert(buffer != NULL); assert(*buffer == NULL); if (prefSize == NULL) { prefSize = &junkPrefSize; } // Open the entity, read out the preference, and then // close it down. *buffer = NULL; err = OTCfgOpenPrefs(ref->dbRef, entityID, false, &prefsRefNum); if (err == noErr) { err = OTCfgGetPrefsSize(prefsRefNum, prefType, prefSize); if (err == noErr) { *buffer = NewPtr( (Size) *prefSize ); if (*buffer == NULL) { assert(err == memFullErr); err = memFullErr; } } if (err == noErr) { err = OTCfgGetPrefs(prefsRefNum, prefType, *buffer, *prefSize); } err2 = OTCfgClosePrefs(prefsRefNum); if (err == noErr) { err = err2; } } // Clean up. if (err != noErr && *buffer != NULL) { DisposePtr( (Ptr) *buffer); assert(MemError() == noErr); *buffer = NULL; } return err;}extern pascal OSStatus MNSSetPref(const MNSDatabaseRef *ref, const CfgEntityRef *entityID, OSType prefType, const void *prefData, ByteCount prefSize) // See comment in interface part.{ OSStatus err; OSStatus err2; CfgEntityAccessID prefsRefNum; assert(MNSValidDatabase(ref)); assert(MNSDatabaseWritable(ref)); assert(entityID != NULL); assert(prefData != NULL); // A prefSize of size is legal. A good example is the // Remote Access 'cadr' preference when you haven't typed // a phone number into the control panel. // // assert(prefSize != 0); err = OTCfgOpenPrefs(ref->dbRef, entityID, true, &prefsRefNum); if (err == noErr) { err = OTCfgSetPrefs(prefsRefNum, prefType, prefData, prefSize); err2 = OTCfgClosePrefs(prefsRefNum); if (err == noErr) { err = err2; } } return err;}extern pascal OSStatus MNSGetPrefHandle(const MNSDatabaseRef *ref, const CfgEntityRef *entityID, OSType prefType, Handle prefData) // See comment in interface part.{ OSStatus err; OSStatus err2; CfgEntityAccessID prefsRefNum; ByteCount prefSize; SInt8 s; assert(MNSValidDatabase(ref)); assert(entityID != NULL); assert(prefData != NULL); // Open the entity, read out the preference, and then // close it down. err = OTCfgOpenPrefs(ref->dbRef, entityID, false, &prefsRefNum); if (err == noErr) { err = OTCfgGetPrefsSize(prefsRefNum, prefType, &prefSize); if (err == noErr) { SetHandleSize(prefData, (Size) prefSize); err = MemError(); } if (err == noErr) { s = HGetState(prefData); HLock(prefData); err = OTCfgGetPrefs(prefsRefNum, prefType, *prefData, prefSize); HSetState(prefData, s); } err2 = OTCfgClosePrefs(prefsRefNum); if (err == noErr) { err = err2; } } return err;}extern pascal OSStatus MNSSetPrefHandle(const MNSDatabaseRef *ref, const CfgEntityRef *entityID, OSType prefType, Handle prefData) // See comment in interface part.{ OSStatus err; SInt8 s; s = HGetState(prefData); assert(MemError() == noErr); HLock(prefData); assert(MemError() == noErr); err = MNSSetPref(ref, entityID, prefType, *prefData, (ByteCount) GetHandleSize(prefData)); HSetState(prefData, s); assert(MemError() == noErr); return err;}extern pascal OSStatus MNSIterateEntity(const MNSDatabaseRef *ref, const CfgEntityRef *entity, MNSPrefIterator iteratorProc, void *refcon) // See comment in interface part.{ OSStatus err; OSStatus err2; CfgEntityAccessID prefsRefNum; ItemCount prefsTOCCount; CfgPrefsHeader *prefsTOCs; ItemCount prefsTOCIndex; OSType prefType; Handle prefDataH; ByteCount prefSize; prefsTOCs = NULL; prefDataH = NULL; prefDataH = NewHandle(0); err = MemError(); if (err == noErr) { err = OTCfgOpenPrefs(ref->dbRef, entity, false, &prefsRefNum); if (err == noErr) { err = OTCfgGetPrefsTOCCount(prefsRefNum, &prefsTOCCount); if (err == noErr) { prefsTOCs = (CfgPrefsHeader *) NewPtr( (Size) (prefsTOCCount * sizeof(CfgPrefsHeader)) ); err = MemError(); } if (err == noErr) { err = OTCfgGetPrefsTOC(prefsRefNum, &prefsTOCCount, prefsTOCs); } if (err == noErr) { for (prefsTOCIndex = 0; prefsTOCIndex < prefsTOCCount; prefsTOCIndex++) { prefType = prefsTOCs[prefsTOCIndex].fType; prefSize = prefsTOCs[prefsTOCIndex].fSize; HUnlock(prefDataH); assert(MemError() == noErr); SetHandleSize(prefDataH, (Size) prefSize); err = MemError(); if (err == noErr) { HLock(prefDataH); assert(MemError() == noErr); err = OTCfgGetPrefs(prefsRefNum, prefType, *prefDataH, prefSize); } if (err == noErr) { iteratorProc(prefType, *prefDataH, prefSize, refcon); } if (err != noErr) { break; } } } err2 = OTCfgClosePrefs(prefsRefNum); if (err == noErr) { err = err2; } } } if (prefsTOCs != NULL) { DisposePtr( (Ptr) prefsTOCs); assert(MemError() == noErr); } if (prefDataH != NULL) { DisposeHandle(prefDataH); assert(MemError() == noErr); } return err;}extern pascal OSStatus MNSGetEntitiesList(const MNSDatabaseRef *ref, OSType entityClass, OSType entityType, ItemCount *entityCount, CfgEntityRef **entityIDs, CfgEntityInfo **entityInfos) // See comment in interface part.{ OSStatus err; CfgEntityRef *paramIDs; CfgEntityInfo *paramInfos; assert(MNSValidDatabase(ref)); assert(entityCount != NULL); assert(entityIDs == NULL || *entityIDs == NULL ); assert(entityInfos == NULL || *entityInfos == NULL); err = OTCfgGetEntitiesCount(ref->dbRef, ref->area, entityClass, entityType, entityCount); if (err == noErr) { if (entityIDs == NULL) { paramIDs = NULL; } else { *entityIDs = (CfgEntityRef *) NewPtr( (Size) (*entityCount * sizeof(CfgEntityRef)) ); if (*entityIDs == NULL) { assert(err == memFullErr); err = memFullErr; } paramIDs = *entityIDs; } } if (err == noErr) { if (entityInfos == NULL) { paramInfos = NULL; } else { *entityInfos = (CfgEntityInfo *) NewPtr( (Size) (*entityCount * sizeof(CfgEntityInfo))); if (*entityInfos == NULL) { assert(err == memFullErr); err = memFullErr; } paramInfos = *entityInfos; } } if (err == noErr) { err = OTCfgGetEntitiesList(ref->dbRef, ref->area, entityClass, entityType, entityCount, paramIDs, paramInfos); } // Clean up. if (err != noErr) { if (*entityIDs != NULL) { DisposePtr( (Ptr) *entityIDs); assert(MemError() == noErr); *entityIDs = NULL; } if (*entityInfos != NULL) { DisposePtr( (Ptr) *entityInfos); assert(MemError() == noErr); *entityInfos = NULL; } } return err;}extern pascal OSStatus MNSFindActiveSet(const MNSDatabaseRef *ref, CfgEntityRef *activeSet) // See comment in interface part.{ OSStatus err; ItemCount setCount; CfgEntityRef *setEntities; Boolean found; ItemCount thisSetIndex; CfgSetsStruct thisStruct; assert(MNSValidDatabase(ref)); assert(activeSet != NULL); setEntities = NULL; err = MNSGetEntitiesList(ref, kOTCfgClassSetOfSettings, kOTCfgTypeSetOfSettings, &setCount, &setEntities, NULL); if (err == noErr) { thisSetIndex = 0; found = false; while (err == noErr && thisSetIndex < setCount && ! found) { err = MNSGetFixedSizePref(ref, &setEntities[thisSetIndex], kOTCfgSetsStructPref, &thisStruct, sizeof(thisStruct)); if (err == noErr) { found = ((thisStruct.fFlags & kOTCfgSetsFlagActiveMask) != 0); if ( ! found ) { thisSetIndex += 1; } } } if (err == noErr && ! found) { err = -2; } } if (err == noErr) { *activeSet = setEntities[thisSetIndex]; } // Clean up. if (setEntities != NULL) { DisposePtr( (Ptr) setEntities); assert(MemError() == noErr); } return err;}extern pascal OSStatus MNSIterateSet(const MNSDatabaseRef *ref, const CfgEntityRef *setEntity, MNSSetIterator iteratorProc, void *refcon, Boolean writeAfterIterate) // See comment in interface part.{ OSStatus err; CfgSetsVector *vectorPrefData; ByteCount vectorPrefSize; ItemCount thisElementIndex; assert(MNSValidDatabase(ref)); assert( !writeAfterIterate || MNSDatabaseWritable(ref) ); assert(setEntity != NULL); assert(iteratorProc != NULL); vectorPrefData = NULL; err = MNSGetPref(ref, setEntity, kOTCfgSetsVectorPref, (void **) &vectorPrefData, &vectorPrefSize); if (err == noErr) { for (thisElementIndex = 0; thisElementIndex < vectorPrefData->fCount; thisElementIndex++) { iteratorProc(ref, &vectorPrefData->fElements[thisElementIndex], refcon); } if (writeAfterIterate) { err = MNSSetPref(ref, setEntity, kOTCfgSetsVectorPref, vectorPrefData, vectorPrefSize); } } // Clean up. if (vectorPrefData != NULL) { DisposePtr( (Ptr) vectorPrefData); assert(MemError() == noErr); } return err;}</pre>
<!--googleoff: index -->
</td>
</tr>
</table>
<!-- END WIDE COLUMN -->
<!-- END MAIN CONTENT -->
<table width="680" border="0" cellpadding="0" cellspacing="0">
<tr>
<td><div style="width: 100%; height: 1px; background-color: #919699; margin-top: 5px; margin-bottom: 15px"></div></td>
</tr>
<tr>
<td align="center"><br/>
<table border="0" cellpadding="0" cellspacing="0" class="graybox">
<tr>
<th>Did this document help you?</th>
</tr>
<tr>
<td>
<div style="margin-bottom: 8px"><a href="http://developer.apple.com/feedback/?v=1&url=/samplecode/QISA/listing47.html%3Fid%3DDTS10000714-1.0&media=dvd" target=_new>Yes</a>: Tell us what works for you.</div>
<div style="margin-bottom: 8px"><a href="http://developer.apple.com/feedback/?v=2&url=/samplecode/QISA/listing47.html%3Fid%3DDTS10000714-1.0&media=dvd" target=_new>It’s good, but:</a> Report typos, inaccuracies, and so forth.</div>
<div><a href="http://developer.apple.com/feedback/?v=3&url=/samplecode/QISA/listing47.html%3Fid%3DDTS10000714-1.0&media=dvd" target=_new>It wasn’t helpful</a>: Tell us what would have helped.</div>
</td>
</tr>
</table>
</td>
</tr>
</table>
<!-- START BOTTOM APPLE NAVIGATION -->
<!--#include virtual="/includes/footer"-->
<!-- END BOTTOM APPLE NAVIGATION -->
<!-- START CENTER CLOSE -->
</center>
<!-- END CENTER CLOSE -->
</body>
</html>