-
Notifications
You must be signed in to change notification settings - Fork 3
/
listing19.html
executable file
·594 lines (508 loc) · 29.2 KB
/
listing19.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/MoreInterfaceLib/RemoteAccessInterface.h</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/MoreInterfaceLib/RemoteAccessInterface.h</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: RemoteAccessInterface.h Contains: Interface for making remote access calls. Written by: Quinn (conversion to Universal Interfaces 3.2 format) Copyright: Copyright (c) 1991-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: RemoteAccessInterface.h,v $Revision 1.4 2002/11/08 23:32:32 eskimo1Convert nil to NULL.Revision 1.3 2001/11/07 15:57:27 eskimo1Tidy up headers, add CVS logs, update copyright. <2> 22/11/00 Quinn Switch to "MacTypes.h". <1> 22/4/99 Quinn First checked in.*/#ifndef __REMOTEACCESSINTERFACE__#define __REMOTEACCESSINTERFACE__#ifndef __TYPES__#include <MacTypes.h>#endif#ifndef __FILES__#include <Files.h>#endif#ifndef __APPLETALK__#include <AppleTalk.h>#endif#if PRAGMA_ONCE#pragma once#endif#ifdef __cplusplusextern "C" {#endif#if PRAGMA_IMPORT#pragma import on#endif#if PRAGMA_STRUCT_ALIGN #pragma options align=mac68k#elif PRAGMA_STRUCT_PACKPUSH #pragma pack(push, 2)#elif PRAGMA_STRUCT_PACK #pragma pack(2)#endif/* **** These callbacks are yet to be Universal Interfaced... **** */typedef pascal void (*UserStatusProcPtr)(UInt8 *, UInt8 *);typedef pascal long (*PacketFilterProcPtr)(UInt8 *, UInt32, UInt32, UInt8 *, UInt32);typedef pascal void (*RemmaperProcPtr)(UInt32, UInt32, UInt32, UInt8 *, UInt8 *);typedef pascal void (*CallBackHookProcPtr)(UInt8 *, UInt32);typedef pascal void (*CallBackCompHookProcPtr)(UInt8 *);typedef pascal UInt32 (*NetValidProcPtr)(UInt8 *,AddrBlock);#define REMOTEACCESSNAME "\pRemote Access"#define REMOTEACCESSID 'strm' // *** NOTE: "Network Extension" uses this id for its _Gestalt call#define gestaltRemoteAccessAttr REMOTEACCESSID#define gestaltRemoteAccessExists 0#define gestaltRemoteAccessCallOnly 1 /* Remote Access Client */#define gestaltRemoteAccessMPServer 2 /* Remote Access multi-port server */#define gestaltRemoteAccessVers2 3 /* ARA 2.0 features are available */#define MAXSTATUSMSGSIZE 256#define USERNAMESIZE 34#define PASSWORDSIZE 8#define PASSWORDBUFSIZE PASSWORDSIZE+1#define TIME_UNLIMITED 0xffffffff /* indicates unlimited time allowed on connection */#define ctlir_getConnectInfo 0x01 /* will get connect info if address is remote */#define ctlir_disposeConnectInfo 0x02 /* will dispose info in connectInfoPtr properly *//* control codes*/#define RAM_EXTENDED_CALL 23 /* make an extended call (use TRemoteAccessParamBlock) *//* extended codes (must have control code set to RAM_EXTENDED_CALL)*//* the first group of calls can be issued without doing a load */#define CmdRemoteAccess_Load 1 /* loads main section of remote access */#define CmdRemoteAccess_Unload 2 /* unloads main section */#define CmdRemoteAccess_PassWordMunger 6 /* create a munged password */#define CmdRemoteAccess_GetCodeHooks 7 /* get code hooks */ /* calls that will not work until CmdRemoteAccess_Load has been done */#define CmdRemoteAccess_DoConnect 40 /* main thread only */#define CmdRemoteAccess_Disconnect 42 /* disconnect */#define CmdRemoteAccess_Status 45 /* get status information */#define CmdRemoteAccess_IsAddressRemote 53 /* main thread only when getting/setting connect pb info */ /* Remote Access errors */#define ERR_BASE -5800#define ERR_NOTCONNECTED (ERR_BASE-0)#define ERR_CONNECTIONABORTED (ERR_BASE-1)#define ERR_ALREADYCONNECTED (ERR_BASE-2)#define ERR_COMMANDALREADYINPROGRESS (ERR_BASE-3)#define ERR_BADVERSION (ERR_BASE-4)#define ERR_INSHUTDOWN (ERR_BASE-5)#define ERR_CONNECTIONABORTING (ERR_BASE-6)#define ERR_ALREADYENABLED (ERR_BASE-7)#define ERR_ZONEBUFBADSIZE (ERR_BASE-8)#define ERR_CONNECTTIMEDOUT (ERR_BASE-9)#define ERR_CONNECTUSERTIMEDOUT (ERR_BASE-10)#define ERR_BADPARAMETER (ERR_BASE-11)#define ERR_NOMULTINODE (ERR_BASE-12)#define ERR_ATALKNOTACTIVE (ERR_BASE-13)#define ERR_NOCALLBACKSUPPORT (ERR_BASE-14)#define ERR_NOTOPENEDBYTHISPB (ERR_BASE-15)#define ERR_NOGLOBALS (ERR_BASE-16)#define ERR_NOSMARTBUFFER (ERR_BASE-17)#define ERR_BADATALKVERS (ERR_BASE-18)#define ERR_VLD8_CONNECT 0#define ERR_VLD8_CALLBACK (ERR_BASE-19)#define ERR_VLD8_BADVERSION (ERR_BASE-20)#define ERR_VLD8_BADUSER (ERR_BASE-21)#define ERR_VLD8_BADPASSWORD (ERR_BASE-22)#define ERR_VLD8_BADLINK (ERR_BASE-23)#define ERR_VLD8_NOCALLBACKALLOWED (ERR_BASE-24)#define ERR_VLD8_ALLCBSERVERSBUSY (ERR_BASE-25)#define ERR_VLD8_GUESTNOTALLOWED (ERR_BASE-26)#define ERR_VLD8_SERVERISIMPOSTER (ERR_BASE-27)#define ERR_VLD8_LOGINNOTENABLED (ERR_BASE-28)#define ERR_REMOTEPORTALREADYEXISTS (ERR_BASE-29)#define ERR_OPENNOTALLOWED (ERR_BASE-30)#define ERR_NOUSERSANDGROUPS (ERR_BASE-31)#define ERR_PORTSHUTDOWN (ERR_BASE-32)#define ERR_PORTDOESNOTEXIST (ERR_BASE-33)#define ERR_PWNEEDEDFORENABLE (ERR_BASE-34)#define ERR_DAMAGED (ERR_BASE-35)#define ERR_NETCONFIGCHANGED (ERR_BASE-36)/* 2.0 and above only\xC9 */#define ERR_NOSUPPORT_ATREMOTE (ERR_BASE-37)#define ERR_CONFLICTING_REQUEST (ERR_BASE-38)#define ERR_VLD8_INVALIDAUTHMETHOD (ERR_BASE-39)#define ERR_VLD8_CONTINUE (ERR_BASE-40)#define ERR_PWCHANGECANCEL (ERR_BASE-41)#define ERR_VLD8_MANUALPASSWORDREQUIRED (ERR_BASE-50)#define ERR_END ERR_VLD8_MANUALPASSWORDREQUIRED /* must be last error */#define kTemplateVers 1 /* current version understood by remote access for the connect template *//* forward defs */typedef union TRemoteAccessParamBlock TRemoteAccessParamBlock;typedef TRemoteAccessParamBlock *TPRemoteAccessParamBlock;/* network transition */struct TNetworkTransition{ unsigned char *privateVars; /* pointer used internally by Remote Access */ NetValidProcPtr netValidProc; /* pointer to the network valid procedure */ Boolean newConnectivity; /* set to true if new connectivity, false if loss of connectivity */};typedef struct TNetworkTransition TNetworkTransition;typedef TNetworkTransition *TPNetworkTransition;#define DControlParamHeader \ QElem *qLink; /*next queue entry*/\ short qType; /*queue type*/\ short ioTrap; /*routine trap*/\ Ptr ioCmdAddr; /*routine address*/\ ProcPtr ioCompletion; /*completion routine*/\ OSErr ioResult; /*result code*/\ long userData; /*for use by the user */\ short unused; /*unused field */\ short ioRefNum; /*driver reference number*/\ short csCode; /*Call command code*/#define DExtendedParam \ DControlParamHeader \ Ptr hReserved1; \ Ptr hReserved2; \ Ptr resultStrPtr; \ Ptr extendedType; /* pointer to identifier string */#define DRemoteAccessParmHeader \ DExtendedParam \ short extendedCode; /* for use by extended call proc */\ Ptr portGlobalsPtr; /* pointer to globals for this port (0=userport) */\struct TRemoteAccessParmHeader{ DRemoteAccessParmHeader};typedef struct TRemoteAccessParmHeader TRemoteAccessParmHeader;struct TRAConnectInfoTemplate{ unsigned long version; /* version of this format */ unsigned long ltType; /* Link Tool type */ long addressInfoLength; /* length of the address information */ Ptr addressInfoPtr; /* pointer to connect address info */ long ltSpecificTemplateLength;/* length of the ltspecific information */ Ptr ltSpecificTemplatePtr; /* pointer to link tool specific params */ unsigned char passWord[PASSWORDBUFSIZE]; /* user password */ unsigned char userName[USERNAMESIZE]; /* user name */ unsigned long connectReminderTimer; /* value for connection reminder in seconds */ unsigned long connectOKWaitTimer; /* how long to wait for OK on reminder timer */ Boolean guestLogin; /* try to log in as a guest */ Boolean passwordSaved; /* set if password is saved */ Boolean guaranteedAccess; /* flag to guarantee access to servers internet */};typedef struct TRAConnectInfoTemplate TRAConnectInfoTemplate;typedef TRAConnectInfoTemplate *TPRAConnectInfoTemplate;/* connect option flags*/#define kNSCanInteract 0x00000001 // User interaction (password prompt) is OK #define kNSShowStatus 0x00000002 // show the status of the connect or disconnect call #define kNSConnectDocument 0x00000004 // connect using the specified document #define kNSPassWordSet 0x00000010 // use the specified password field when connecting by document // 2.0 and above\xC9#define kNS2SavvyFlags 0x40000000 // Set to use the next 2 flags below for only ARA 2.0 aware applications.#define kNSAR2Connection 0x00000020 // connecting to a 2.0 server. #define kNSNotifyWhileConnected 0x00000040 // display cute notification icon while connected.struct TRemoteAccessConnectParam{ DRemoteAccessParmHeader TRAConnectInfoTemplate connectInfo; /* The connection infomation template */ unsigned long optionFlags; // bit mapped connect option flags FSSpec fileInfo; // file info for connect document };typedef struct TRemoteAccessConnectParam TRemoteAccessConnectParam;#define kNumWarnEntriesMax 5 /* number of entries in warn array */struct TRemoteAccessDisconnectParam{ DRemoteAccessParmHeader unsigned long disconnectin; /* server mode: disconnect in # of seconds */ TPRemoteAccessParamBlock abortOnlyThisPB; /* only abort a connection opened by this pb */ unsigned long warnArr[kNumWarnEntriesMax]; /* set warn times here in seconds (zero all if no warnings) */ unsigned long optionFlags; /* bit mapped connect option flags */};typedef struct TRemoteAccessDisconnectParam TRemoteAccessDisconnectParam;/* bits passed back in status call */#define CctlConnected 0x00000001 /* set when connected */#define CctlAnswerEnable 0x00000004 /* set when we are set to answer calls */#define CctlServerMode 0x00000008 /* set for server mode, clear for remote mode */#define CctlConnectionAborting 0x00000010 /* connection is being torn down */#define CctlConnectInProg 0x00000020 /* set when connection in progress or fully connected */#define CctlDisconnectInStarted 0x00008000 /* somebody has started a disconnectIn */#define CctlGuestMode 0x00080000 /* set if this port is logged on with guest access */#define ctlAR2Connection 0x02000000 /* set when this connection is to a 2.0 server */#define ctlNotifyWhileConnected 0x04000000 /* set when the user wants to be reminded while connected */#define ctlConnectedToMPS 0x08000000 /* set when client is connected to a multi-port server */#define CctlMultiNodeReady 0x80000000 /* shows if we currently have a multinode address */struct TRemoteAccessStatusParam{ DRemoteAccessParmHeader unsigned long statusBits; /* bits for current status */ unsigned long timeConnected; /* number of seconds we have been connected */ unsigned long timeLeft; /* number of seconds remaining in connection (0xffffffff infinite) */ unsigned char *userNamePtr; /* returns user name, expects pointer to buffer of USERNAMESIZE if non NULL */ unsigned char *connectedToNamePtr; /* returns name of where we connected to, expects pointer to buffer of USERNAMESIZE if non NULL */ TPRemoteAccessParamBlock connectedByParamPtr; /* a pointer to the parameter block "initiating" the connection if we are connected */ TPRemoteAccessParamBlock statusConnectedByParamPtr; /* a pointer to the parameter block "initiating" the connection when status was posted */ unsigned char *theLastStatusMsgPtr; /* expects pointer to buffer of size MAXSTATUSMSGSIZE */ unsigned char *statusUserNamePtr; /* pointer to buffer of size USERNAMESIZE */ long statuslttype; /* link tool type */ long statusmsgOptionFlags; /* classification of message type */ long statusMsgNum; /* specific message number */ long statusMsgSeqNum; /* pass in zero if always want status, otherwise use last value, if status is new, new number is returned */ unsigned long userSignature; /* signature of port creator */ unsigned long userRefCon; /* refcon of port creator */};typedef struct TRemoteAccessStatusParam TRemoteAccessStatusParam;struct TRemoteAccessIsRemoteParms{ DRemoteAccessParmHeader long theAddress; /* address that is to be checked */ unsigned long optionFlags; /* Set to ctlir_getConnectInfo or ctlir_disposeConnectInfo, if zero only checks address */ Boolean locationIsRemoteFlag; /* returns true if address is remote */ long ConnectInfoLength; /* length of the following data */ TPRAConnectInfoTemplate connectInfoPtr; /* The connection information template pointer */};typedef struct TRemoteAccessIsRemoteParms TRemoteAccessIsRemoteParms;struct TRemoteAccessPasswordMunger{ DRemoteAccessParmHeader unsigned char *userNamePtr; /* pointer to username string */ unsigned char *passWordPtr; /* user password */ unsigned short reserved; /* must set to zero */};typedef struct TRemoteAccessPasswordMunger TRemoteAccessPasswordMunger;struct TRemoteAccessGetCodeHooks{ DRemoteAccessParmHeader RemmaperProcPtr remapperProc; /* quick vector to remapper code */};typedef struct TRemoteAccessGetCodeHooks TRemoteAccessGetCodeHooks;/* this is the union of all the different command types */union TRemoteAccessParamBlock{ TRemoteAccessParmHeader HDR; /* header pb */ TRemoteAccessParmHeader LOAD; /* load pb */ TRemoteAccessParmHeader UNLOAD; /* unload pb */ TRemoteAccessConnectParam CONNECT; /* connect pb */ TRemoteAccessDisconnectParam DISCONNECT; /* disconnect pb */ TRemoteAccessStatusParam STATUS; /* get current status */ TRemoteAccessIsRemoteParms ISREMOTE; /* used to check network address location */ TRemoteAccessPasswordMunger MUNGEPW; /* run password through munger */ TRemoteAccessGetCodeHooks CODEHOOKS; /* get internal code hooks */ unsigned char filler[256]; /* set the minimum size of this parameter block */};EXTERN_API ( OSErr ) PBRemoteAccess(TPRemoteAccessParamBlock paramBlock, Boolean async) TWOWORDINLINE(0x7000,0xAA5B);#if PRAGMA_STRUCT_ALIGN #pragma options align=reset#elif PRAGMA_STRUCT_PACKPUSH #pragma pack(pop)#elif PRAGMA_STRUCT_PACK #pragma pack()#endif#ifdef PRAGMA_IMPORT_OFF#pragma import off#elif PRAGMA_IMPORT#pragma import reset#endif#ifdef __cplusplus}#endif#endif /* __REMOTEACCESSINTERFACE__ */</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/listing19.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/listing19.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/listing19.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>