1 {
2 File: CarbonCore/Aliases.h
3
4 Contains: Alias Manager Interfaces.
5 The contents of this header file are deprecated.
6 Use Foundation or CoreFoundation URL Bookmarks instead.
7
8 Copyright: � 1989-2011 by Apple Inc. All rights reserved.
9 }
10 {
11 Modified for use with Free Pascal
12 Version 308
13 Please report any bugs to <gpc@microbizz.nl>
14 }
15
16 {$ifc not defined MACOSALLINCLUDE or not MACOSALLINCLUDE}
17 {$mode macpas}
18 {$modeswitch cblocks}
19 {$packenum 1}
20 {$macro on}
21 {$inline on}
22 {$calling mwpascal}
23
24 unit Aliases;
25 interface
26 {$setc UNIVERSAL_INTERFACES_VERSION := $0400}
27 {$setc GAP_INTERFACES_VERSION := $0308}
28
29 {$ifc not defined USE_CFSTR_CONSTANT_MACROS}
30 {$setc USE_CFSTR_CONSTANT_MACROS := TRUE}
31 {$endc}
32
33 {$ifc defined CPUPOWERPC and defined CPUI386}
34 {$error Conflicting initial definitions for CPUPOWERPC and CPUI386}
35 {$endc}
36 {$ifc defined FPC_BIG_ENDIAN and defined FPC_LITTLE_ENDIAN}
37 {$error Conflicting initial definitions for FPC_BIG_ENDIAN and FPC_LITTLE_ENDIAN}
38 {$endc}
39
40 {$ifc not defined __ppc__ and defined CPUPOWERPC32}
41 {$setc __ppc__ := 1}
42 {$elsec}
43 {$setc __ppc__ := 0}
44 {$endc}
45 {$ifc not defined __ppc64__ and defined CPUPOWERPC64}
46 {$setc __ppc64__ := 1}
47 {$elsec}
48 {$setc __ppc64__ := 0}
49 {$endc}
50 {$ifc not defined __i386__ and defined CPUI386}
51 {$setc __i386__ := 1}
52 {$elsec}
53 {$setc __i386__ := 0}
54 {$endc}
55 {$ifc not defined __x86_64__ and defined CPUX86_64}
56 {$setc __x86_64__ := 1}
57 {$elsec}
58 {$setc __x86_64__ := 0}
59 {$endc}
60 {$ifc not defined __arm__ and defined CPUARM}
61 {$setc __arm__ := 1}
62 {$elsec}
63 {$setc __arm__ := 0}
64 {$endc}
65 {$ifc not defined __arm64__ and defined CPUAARCH64}
66 {$setc __arm64__ := 1}
67 {$elsec}
68 {$setc __arm64__ := 0}
69 {$endc}
70
71 {$ifc defined cpu64}
72 {$setc __LP64__ := 1}
73 {$elsec}
74 {$setc __LP64__ := 0}
75 {$endc}
76
77
78 {$ifc defined __ppc__ and __ppc__ and defined __i386__ and __i386__}
79 {$error Conflicting definitions for __ppc__ and __i386__}
80 {$endc}
81
82 {$ifc defined __ppc__ and __ppc__}
83 {$setc TARGET_CPU_PPC := TRUE}
84 {$setc TARGET_CPU_PPC64 := FALSE}
85 {$setc TARGET_CPU_X86 := FALSE}
86 {$setc TARGET_CPU_X86_64 := FALSE}
87 {$setc TARGET_CPU_ARM := FALSE}
88 {$setc TARGET_CPU_ARM64 := FALSE}
89 {$setc TARGET_OS_MAC := TRUE}
90 {$setc TARGET_OS_IPHONE := FALSE}
91 {$setc TARGET_IPHONE_SIMULATOR := FALSE}
92 {$setc TARGET_OS_EMBEDDED := FALSE}
93 {$elifc defined __ppc64__ and __ppc64__}
94 {$setc TARGET_CPU_PPC := FALSE}
95 {$setc TARGET_CPU_PPC64 := TRUE}
96 {$setc TARGET_CPU_X86 := FALSE}
97 {$setc TARGET_CPU_X86_64 := FALSE}
98 {$setc TARGET_CPU_ARM := FALSE}
99 {$setc TARGET_CPU_ARM64 := FALSE}
100 {$setc TARGET_OS_MAC := TRUE}
101 {$setc TARGET_OS_IPHONE := FALSE}
102 {$setc TARGET_IPHONE_SIMULATOR := FALSE}
103 {$setc TARGET_OS_EMBEDDED := FALSE}
104 {$elifc defined __i386__ and __i386__}
105 {$setc TARGET_CPU_PPC := FALSE}
106 {$setc TARGET_CPU_PPC64 := FALSE}
107 {$setc TARGET_CPU_X86 := TRUE}
108 {$setc TARGET_CPU_X86_64 := FALSE}
109 {$setc TARGET_CPU_ARM := FALSE}
110 {$setc TARGET_CPU_ARM64 := FALSE}
111 {$ifc defined iphonesim}
112 {$setc TARGET_OS_MAC := FALSE}
113 {$setc TARGET_OS_IPHONE := TRUE}
114 {$setc TARGET_IPHONE_SIMULATOR := TRUE}
115 {$elsec}
116 {$setc TARGET_OS_MAC := TRUE}
117 {$setc TARGET_OS_IPHONE := FALSE}
118 {$setc TARGET_IPHONE_SIMULATOR := FALSE}
119 {$endc}
120 {$setc TARGET_OS_EMBEDDED := FALSE}
121 {$elifc defined __x86_64__ and __x86_64__}
122 {$setc TARGET_CPU_PPC := FALSE}
123 {$setc TARGET_CPU_PPC64 := FALSE}
124 {$setc TARGET_CPU_X86 := FALSE}
125 {$setc TARGET_CPU_X86_64 := TRUE}
126 {$setc TARGET_CPU_ARM := FALSE}
127 {$setc TARGET_CPU_ARM64 := FALSE}
128 {$ifc defined iphonesim}
129 {$setc TARGET_OS_MAC := FALSE}
130 {$setc TARGET_OS_IPHONE := TRUE}
131 {$setc TARGET_IPHONE_SIMULATOR := TRUE}
132 {$elsec}
133 {$setc TARGET_OS_MAC := TRUE}
134 {$setc TARGET_OS_IPHONE := FALSE}
135 {$setc TARGET_IPHONE_SIMULATOR := FALSE}
136 {$endc}
137 {$setc TARGET_OS_EMBEDDED := FALSE}
138 {$elifc defined __arm__ and __arm__}
139 {$setc TARGET_CPU_PPC := FALSE}
140 {$setc TARGET_CPU_PPC64 := FALSE}
141 {$setc TARGET_CPU_X86 := FALSE}
142 {$setc TARGET_CPU_X86_64 := FALSE}
143 {$setc TARGET_CPU_ARM := TRUE}
144 {$setc TARGET_CPU_ARM64 := FALSE}
145 {$setc TARGET_OS_MAC := FALSE}
146 {$setc TARGET_OS_IPHONE := TRUE}
147 {$setc TARGET_IPHONE_SIMULATOR := FALSE}
148 {$setc TARGET_OS_EMBEDDED := TRUE}
149 {$elifc defined __arm64__ and __arm64__}
150 {$setc TARGET_CPU_PPC := FALSE}
151 {$setc TARGET_CPU_PPC64 := FALSE}
152 {$setc TARGET_CPU_X86 := FALSE}
153 {$setc TARGET_CPU_X86_64 := FALSE}
154 {$setc TARGET_CPU_ARM := FALSE}
155 {$setc TARGET_CPU_ARM64 := TRUE}
156 {$ifc defined ios}
157 {$setc TARGET_OS_MAC := FALSE}
158 {$setc TARGET_OS_IPHONE := TRUE}
159 {$setc TARGET_OS_EMBEDDED := TRUE}
160 {$elsec}
161 {$setc TARGET_OS_MAC := TRUE}
162 {$setc TARGET_OS_IPHONE := FALSE}
163 {$setc TARGET_OS_EMBEDDED := FALSE}
164 {$endc}
165 {$setc TARGET_IPHONE_SIMULATOR := FALSE}
166 {$elsec}
167 {$error __ppc__ nor __ppc64__ nor __i386__ nor __x86_64__ nor __arm__ nor __arm64__ is defined.}
168 {$endc}
169
170 {$ifc defined __LP64__ and __LP64__ }
171 {$setc TARGET_CPU_64 := TRUE}
172 {$elsec}
173 {$setc TARGET_CPU_64 := FALSE}
174 {$endc}
175
176 {$ifc defined FPC_BIG_ENDIAN}
177 {$setc TARGET_RT_BIG_ENDIAN := TRUE}
178 {$setc TARGET_RT_LITTLE_ENDIAN := FALSE}
179 {$elifc defined FPC_LITTLE_ENDIAN}
180 {$setc TARGET_RT_BIG_ENDIAN := FALSE}
181 {$setc TARGET_RT_LITTLE_ENDIAN := TRUE}
182 {$elsec}
183 {$error Neither FPC_BIG_ENDIAN nor FPC_LITTLE_ENDIAN are defined.}
184 {$endc}
185 {$setc ACCESSOR_CALLS_ARE_FUNCTIONS := TRUE}
186 {$setc CALL_NOT_IN_CARBON := FALSE}
187 {$setc OLDROUTINENAMES := FALSE}
188 {$setc OPAQUE_TOOLBOX_STRUCTS := TRUE}
189 {$setc OPAQUE_UPP_TYPES := TRUE}
190 {$setc OTCARBONAPPLICATION := TRUE}
191 {$setc OTKERNEL := FALSE}
192 {$setc PM_USE_SESSION_APIS := TRUE}
193 {$setc TARGET_API_MAC_CARBON := TRUE}
194 {$setc TARGET_API_MAC_OS8 := FALSE}
195 {$setc TARGET_API_MAC_OSX := TRUE}
196 {$setc TARGET_CARBON := TRUE}
197 {$setc TARGET_CPU_68K := FALSE}
198 {$setc TARGET_CPU_MIPS := FALSE}
199 {$setc TARGET_CPU_SPARC := FALSE}
200 {$setc TARGET_OS_UNIX := FALSE}
201 {$setc TARGET_OS_WIN32 := FALSE}
202 {$setc TARGET_RT_MAC_68881 := FALSE}
203 {$setc TARGET_RT_MAC_CFM := FALSE}
204 {$setc TARGET_RT_MAC_MACHO := TRUE}
205 {$setc TYPED_FUNCTION_POINTERS := TRUE}
206 {$setc TYPE_BOOL := FALSE}
207 {$setc TYPE_EXTENDED := FALSE}
208 {$setc TYPE_LONGLONG := TRUE}
209 uses MacTypes,Files,UTCUtils,CFBase;
210 {$endc} {not MACOSALLINCLUDE}
211
212
213 {$ifc TARGET_OS_MAC}
214
215 {$ALIGN MAC68K}
216
217
218 type
219 FSAliasInfoBitmap = UInt32;
220 FSAliasInfoBitmapPtr = ^FSAliasInfoBitmap;
221 const
222 kFSAliasInfoNone = $00000000; { no valid info}
223 kFSAliasInfoVolumeCreateDate = $00000001; { volume creation date is valid}
224 kFSAliasInfoTargetCreateDate = $00000002; { target creation date is valid}
225 kFSAliasInfoFinderInfo = $00000004; { file type and creator are valid}
226 kFSAliasInfoIsDirectory = $00000008; { isDirectory boolean is valid}
227 kFSAliasInfoIDs = $00000010; { parentDirID and nodeID are valid}
228 kFSAliasInfoFSInfo = $00000020; { filesystemID and signature are valid}
229 kFSAliasInfoVolumeFlags = $00000040; { volumeIsBootVolume, volumeIsAutomounted, volumeIsEjectable and volumeHasPersistentFileIDs are valid}
230
231 const
232 rAliasType = FourCharCode('alis'); { Aliases are stored as resources of this type }
233
234 const
235 { define alias resolution action rules mask }
236 kARMMountVol = $00000001; { mount the volume automatically }
237 kARMNoUI = $00000002; { no user interface allowed during resolution }
238 kARMMultVols = $00000008; { search on multiple volumes }
239 kARMSearch = $00000100; { search quickly }
240 kARMSearchMore = $00000200; { search further }
241 kARMSearchRelFirst = $00000400; { search target on a relative path first }
242 kARMTryFileIDFirst = $00000800; { search by file id before path }
243
244 const
245 { define alias record information types }
246 asiZoneName = -3; { get zone name }
247 asiServerName = -2; { get server name }
248 asiVolumeName = -1; { get volume name }
249 asiAliasName = 0; { get aliased file/folder/volume name }
250 asiParentName = 1; { get parent folder name }
251
252 { ResolveAliasFileWithMountFlags options }
253 const
254 kResolveAliasFileNoUI = $00000001; { no user interaction during resolution }
255 kResolveAliasTryFileIDFirst = $00000002; { search by file id before path }
256
257 { define the alias record that will be the blackbox for the caller }
258
259 type
260 AliasRecordPtr = ^AliasRecord;
261 { Opaque as of Mac OS X 10.4 ... }
262 AliasRecord = record
263 userType: OSType; { appl stored type like creator type }
264 aliasSize: UInt16; { alias record size in bytes, for appl usage }
265 end;
266
267 type
268 AliasPtr = AliasRecordPtr;
269 AliasHandle = ^AliasPtr;
270 { info block to pass to FSCopyAliasInfo }
271 type
272 FSAliasInfo = record
273 volumeCreateDate: UTCDateTime;
274 targetCreateDate: UTCDateTime;
275 fileType: OSType;
276 fileCreator: OSType;
277 parentDirID: UInt32;
278 nodeID: UInt32;
279 filesystemID: UInt16;
280 signature: UInt16;
281 volumeIsBootVolume: Boolean;
282 volumeIsAutomounted: Boolean;
283 volumeIsEjectable: Boolean;
284 volumeHasPersistentFileIDs: Boolean;
285 isDirectory: Boolean;
286 end;
287 FSAliasInfoPtr = ^FSAliasInfo;
288 { alias record information type }
289 type
290 AliasInfoType = SInt16;
291 {$ifc not TARGET_CPU_64}
292 type
cpbPtrnull293 AliasFilterProcPtr = function( cpbPtr: CInfoPBPtr; var quitFlag: Boolean; myDataPtr: Ptr ): Boolean;
294 AliasFilterUPP = AliasFilterProcPtr;
295 {
296 * NewAliasFilterUPP()
297 *
298 * Availability:
299 * Mac OS X: in version 10.0 and later in CoreServices.framework
300 * CarbonLib: in CarbonLib 1.0 and later
301 * Non-Carbon CFM: available as macro/inline
302 }
303 { old name was NewAliasFilterProc }
NewAliasFilterUPPnull304 function NewAliasFilterUPP( userRoutine: AliasFilterProcPtr ): AliasFilterUPP; external name '_NewAliasFilterUPP';
305 (* __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_0, __MAC_10_8, __IPHONE_NA, __IPHONE_NA) *)
306 {
307 * DisposeAliasFilterUPP()
308 *
309 * Availability:
310 * Mac OS X: in version 10.0 and later in CoreServices.framework
311 * CarbonLib: in CarbonLib 1.0 and later
312 * Non-Carbon CFM: available as macro/inline
313 }
314 procedure DisposeAliasFilterUPP( userUPP: AliasFilterUPP ); external name '_DisposeAliasFilterUPP';
315 (* __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_0, __MAC_10_8, __IPHONE_NA, __IPHONE_NA) *)
316
317 {
318 * InvokeAliasFilterUPP()
319 *
320 * Availability:
321 * Mac OS X: in version 10.0 and later in CoreServices.framework
322 * CarbonLib: in CarbonLib 1.0 and later
323 * Non-Carbon CFM: available as macro/inline
324 }
InvokeAliasFilterUPPnull325 function InvokeAliasFilterUPP( cpbPtr: CInfoPBPtr; var quitFlag: Boolean; myDataPtr: Ptr; userUPP: AliasFilterUPP ): Boolean; external name '_InvokeAliasFilterUPP';
326 (* __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_0, __MAC_10_8, __IPHONE_NA, __IPHONE_NA) *)
327
328 {#if __MACH__
329 #define NewAliasFilterUPP(userRoutine) ((AliasFilterUPP)userRoutine)
330 #define DisposeAliasFilterUPP(userUPP)
331 #define InvokeAliasFilterUPP(cpbPtr, quitFlag, myDataPtr, userUPP) (*userUPP)(cpbPtr, quitFlag, myDataPtr)
332 #endif}
333
334 {$endc} {not TARGET_CPU_64}
335
336 type
constnull337 FSAliasFilterProcPtr = function( const (*var*) ref: FSRef; var quitFlag: Boolean; myDataPtr: Ptr ): Boolean;
338 FSAliasFilterUPP = FSAliasFilterProcPtr;
339
340 {
341 * FSNewAlias()
342 *
343 * Mac OS X threading:
344 * Thread safe since version 10.3
345 *
346 * Availability:
347 * Mac OS X: in version 10.0 and later in CoreServices.framework
348 * CarbonLib: in CarbonLib 1.1 and later
349 * Non-Carbon CFM: in InterfaceLib 9.1 and later
350 }
351 function FSNewAlias( {const} fromFile: FSRefPtr { can be NULL }; const (*var*) target: FSRef; var inAlias: AliasHandle ): OSErr; external name '_FSNewAlias';
352 (* __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_0, __MAC_10_8, __IPHONE_NA, __IPHONE_NA) *)
353
354
355 {
356 * FSNewAliasMinimal()
357 *
358 * Mac OS X threading:
359 * Thread safe since version 10.3
360 *
361 * Availability:
362 * Mac OS X: in version 10.0 and later in CoreServices.framework
363 * CarbonLib: in CarbonLib 1.1 and later
364 * Non-Carbon CFM: in InterfaceLib 9.1 and later
365 }
FSNewAliasMinimalnull366 function FSNewAliasMinimal( const (*var*) target: FSRef; var inAlias: AliasHandle ): OSErr; external name '_FSNewAliasMinimal';
367 (* __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_0, __MAC_10_8, __IPHONE_NA, __IPHONE_NA) *)
368
369
370 {
371 * FSIsAliasFile()
372 *
373 * Mac OS X threading:
374 * Thread safe since version 10.3
375 *
376 * Availability:
377 * Mac OS X: in version 10.0 and later in CoreServices.framework
378 * CarbonLib: in CarbonLib 1.1 and later
379 * Non-Carbon CFM: in InterfaceLib 9.1 and later
380 }
FSIsAliasFilenull381 function FSIsAliasFile( const (*var*) fileRef: FSRef; var aliasFileFlag: Boolean; var folderFlag: Boolean ): OSErr; external name '_FSIsAliasFile';
382 (* __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_0, __MAC_10_8, __IPHONE_NA, __IPHONE_NA) *)
383
384
385 {
386 * FSResolveAliasWithMountFlags()
387 *
388 * Mac OS X threading:
389 * Thread safe since version 10.3
390 *
391 * Availability:
392 * Mac OS X: in version 10.0 and later in CoreServices.framework
393 * CarbonLib: in CarbonLib 1.1 and later
394 * Non-Carbon CFM: in InterfaceLib 9.1 and later
395 }
FSResolveAliasWithMountFlagsnull396 function FSResolveAliasWithMountFlags( {const} fromFile: FSRefPtr { can be NULL }; inAlias: AliasHandle; var target: FSRef; var wasChanged: Boolean; mountFlags: UNSIGNEDLONG ): OSErr; external name '_FSResolveAliasWithMountFlags';
397 (* __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_0, __MAC_10_8, __IPHONE_NA, __IPHONE_NA) *)
398
399
400 {
401 * FSResolveAlias()
402 *
403 * Mac OS X threading:
404 * Thread safe since version 10.3
405 *
406 * Availability:
407 * Mac OS X: in version 10.0 and later in CoreServices.framework
408 * CarbonLib: in CarbonLib 1.1 and later
409 * Non-Carbon CFM: in InterfaceLib 9.1 and later
410 }
FSResolveAliasnull411 function FSResolveAlias( {const} fromFile: FSRefPtr { can be NULL }; alias: AliasHandle; var target: FSRef; var wasChanged: Boolean ): OSErr; external name '_FSResolveAlias';
412 (* __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_0, __MAC_10_8, __IPHONE_NA, __IPHONE_NA) *)
413
414
415 {
416 * FSResolveAliasFileWithMountFlags()
417 *
418 * Mac OS X threading:
419 * Thread safe since version 10.3
420 *
421 * Availability:
422 * Mac OS X: in version 10.0 and later in CoreServices.framework
423 * CarbonLib: in CarbonLib 1.1 and later
424 * Non-Carbon CFM: in InterfaceLib 9.1 and later
425 }
FSResolveAliasFileWithMountFlagsnull426 function FSResolveAliasFileWithMountFlags( var theRef: FSRef; resolveAliasChains: Boolean; var targetIsFolder: Boolean; var wasAliased: Boolean; mountFlags: UNSIGNEDLONG ): OSErr; external name '_FSResolveAliasFileWithMountFlags';
427 (* __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_0, __MAC_10_8, __IPHONE_NA, __IPHONE_NA) *)
428
429
430 {
431 * FSResolveAliasFile()
432 *
433 * Mac OS X threading:
434 * Thread safe since version 10.3
435 *
436 * Availability:
437 * Mac OS X: in version 10.0 and later in CoreServices.framework
438 * CarbonLib: in CarbonLib 1.1 and later
439 * Non-Carbon CFM: in InterfaceLib 9.1 and later
440 }
FSResolveAliasFilenull441 function FSResolveAliasFile( var theRef: FSRef; resolveAliasChains: Boolean; var targetIsFolder: Boolean; var wasAliased: Boolean ): OSErr; external name '_FSResolveAliasFile';
442 (* __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_0, __MAC_10_8, __IPHONE_NA, __IPHONE_NA) *)
443
444
445 {
446 * FSFollowFinderAlias()
447 *
448 * Mac OS X threading:
449 * Thread safe since version 10.3
450 *
451 * Availability:
452 * Mac OS X: in version 10.0 and later in CoreServices.framework
453 * CarbonLib: in CarbonLib 1.1 and later
454 * Non-Carbon CFM: in InterfaceLib 9.1 and later
455 }
FSFollowFinderAliasnull456 function FSFollowFinderAlias( fromFile: FSRefPtr { can be NULL }; alias: AliasHandle; logon: Boolean; var target: FSRef; var wasChanged: Boolean ): OSErr; external name '_FSFollowFinderAlias';
457 (* __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_0, __MAC_10_8, __IPHONE_NA, __IPHONE_NA) *)
458
459
460 {
461 * FSUpdateAlias()
462 *
463 * Mac OS X threading:
464 * Thread safe since version 10.3
465 *
466 * Availability:
467 * Mac OS X: in version 10.0 and later in CoreServices.framework
468 * CarbonLib: in CarbonLib 1.1 and later
469 * Non-Carbon CFM: in InterfaceLib 9.1 and later
470 }
FSUpdateAliasnull471 function FSUpdateAlias( {const} fromFile: FSRefPtr { can be NULL }; const (*var*) target: FSRef; alias: AliasHandle; var wasChanged: Boolean ): OSErr; external name '_FSUpdateAlias';
472 (* __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_0, __MAC_10_8, __IPHONE_NA, __IPHONE_NA) *)
473
474
475 {
476 * FSNewAliasUnicode()
477 *
478 * Summary:
479 * Creates an alias given a ref to the target's parent directory and
480 * the target's unicode name. If the target does not exist fnfErr
481 * will be returned but the alias will still be created. This
482 * allows the creation of aliases to targets that do not exist.
483 *
484 * Mac OS X threading:
485 * Thread safe since version 10.3
486 *
487 * Parameters:
488 *
489 * fromFile:
490 * The starting point for a relative search.
491 *
492 * targetParentRef:
493 * An FSRef to the parent directory of the target.
494 *
495 * targetNameLength:
496 * Number of Unicode characters in the target's name.
497 *
498 * targetName:
499 * A pointer to the Unicode name.
500 *
501 * inAlias:
502 * A Handle to the newly created alias record.
503 *
504 * isDirectory:
505 * On input, if target does not exist, a flag to indicate whether
506 * or not the target is a directory. On output, if the target did
507 * exist, a flag indicating if the target is a directory. Pass
508 * NULL in the non-existant case if unsure.
509 *
510 * Availability:
511 * Mac OS X: in version 10.2 and later in CoreServices.framework
512 * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.2 and later
513 * Non-Carbon CFM: not available
514 }
FSNewAliasUnicodenull515 function FSNewAliasUnicode( {const} fromFile: FSRefPtr { can be NULL }; const (*var*) targetParentRef: FSRef; targetNameLength: UniCharCount; targetName: ConstUniCharPtr; var inAlias: AliasHandle; isDirectory: BooleanPtr { can be NULL } ): OSErr; external name '_FSNewAliasUnicode';
516 (* __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_2, __MAC_10_8, __IPHONE_NA, __IPHONE_NA) *)
517
518
519 {
520 * FSNewAliasMinimalUnicode()
521 *
522 * Summary:
523 * Creates a minimal alias given a ref to the target's parent
524 * directory and the target's unicode name. If the target does not
525 * exist fnfErr will be returned but the alias will still be created.
526 *
527 * Mac OS X threading:
528 * Thread safe since version 10.3
529 *
530 * Parameters:
531 *
532 * targetParentRef:
533 * An FSRef to the parent directory of the target.
534 *
535 * targetNameLength:
536 * Number of Unicode characters in the target's name.
537 *
538 * targetName:
539 * A pointer to the Unicode name.
540 *
541 * inAlias:
542 * A Handle to the newly created alias record.
543 *
544 * isDirectory:
545 * On input, if target does not exist, a flag to indicate whether
546 * or not the target is a directory. On output, if the target did
547 * exist, a flag indicating if the target is a directory. Pass
548 * NULL in the non-existant case if unsure.
549 *
550 * Availability:
551 * Mac OS X: in version 10.2 and later in CoreServices.framework
552 * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.2 and later
553 * Non-Carbon CFM: not available
554 }
FSNewAliasMinimalUnicodenull555 function FSNewAliasMinimalUnicode( const (*var*) targetParentRef: FSRef; targetNameLength: UniCharCount; targetName: ConstUniCharPtr; var inAlias: AliasHandle; isDirectory: BooleanPtr { can be NULL } ): OSErr; external name '_FSNewAliasMinimalUnicode';
556 (* __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_2, __MAC_10_8, __IPHONE_NA, __IPHONE_NA) *)
557
558
559 {
560 * FSNewAliasFromPath()
561 *
562 * Summary:
563 * Creates an alias given a POSIX style utf-8 path to the target.
564 * If the target file does not exist but the path up to the leaf
565 * does then fnfErr will be returned but the alias will still be
566 * created.
567 *
568 * Mac OS X threading:
569 * Thread safe since version 10.5
570 *
571 * Parameters:
572 *
573 * fromFilePath:
574 * The starting point for a relative search.
575 *
576 * targetPath:
577 * POSIX style UTF-8 path to target.
578 *
579 * flags:
580 * Options for future use. Pass in 0.
581 *
582 * inAlias:
583 * A Handle to the newly created alias record.
584 *
585 * isDirectory:
586 * On input, if target does not exist, a flag to indicate whether
587 * or not the target is a directory. On output, if the target did
588 * exist, a flag indicating if the target is a directory. Pass
589 * NULL in the non-existant case if unsure.
590 *
591 * Availability:
592 * Mac OS X: in version 10.5 and later in CoreServices.framework
593 * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.5 and later
594 * Non-Carbon CFM: not available
595 }
FSNewAliasFromPathnull596 function FSNewAliasFromPath( fromFilePath: ConstCStringPtr { can be NULL }; targetPath: ConstCStringPtr; flags: OptionBits; var inAlias: AliasHandle; isDirectory: BooleanPtr { can be NULL } ): OSStatus; external name '_FSNewAliasFromPath';
597 (* __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_5, __MAC_10_8, __IPHONE_NA, __IPHONE_NA) *)
598
599
600 {
601 * FSMatchAliasBulk()
602 *
603 * Summary:
604 * Given an alias handle and fromFile, match the alias and return
605 * FSRefs to the aliased file(s) and needsUpdate flag
606 *
607 * Mac OS X threading:
608 * Thread safe since version 10.5
609 *
610 * Availability:
611 * Mac OS X: in version 10.5 and later in CoreServices.framework
612 * CarbonLib: not available
613 * Non-Carbon CFM: not available
614 }
FSMatchAliasBulknull615 function FSMatchAliasBulk( {const} fromFile: FSRefPtr { can be NULL }; rulesMask: UNSIGNEDLONG; inAlias: AliasHandle; var aliasCount: SInt16; var aliasList: FSRef; var needsUpdate: Boolean; aliasFilter: FSAliasFilterProcPtr { can be NULL }; yourDataPtr: UnivPtr { can be NULL } ): OSStatus; external name '_FSMatchAliasBulk';
616 (* __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_5, __MAC_10_8, __IPHONE_NA, __IPHONE_NA) *)
617
618
619 {
620 * FSCopyAliasInfo()
621 *
622 * Discussion:
623 * This routine will return the requested information from the
624 * passed in aliasHandle. The information is gathered only from the
625 * alias record so it may not match what is on disk (no disk i/o is
626 * performed). The whichInfo paramter is an output parameter that
627 * signifies which fields in the info record contain valid data.
628 *
629 * Mac OS X threading:
630 * Thread safe since version 10.2
631 *
632 * Parameters:
633 *
634 * inAlias:
635 * A handle to the alias record to get the information from.
636 *
637 * targetName:
638 * The name of the target item.
639 *
640 * volumeName:
641 * The name of the volume the target resides on.
642 *
643 * pathString:
644 * POSIX path to target.
645 *
646 * whichInfo:
647 * An indication of which fields in the info block contain valid
648 * data.
649 *
650 * info:
651 * Returned information about the alias.
652 *
653 * Availability:
654 * Mac OS X: in version 10.2 and later in CoreServices.framework
655 * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.2 and later
656 * Non-Carbon CFM: not available
657 }
FSCopyAliasInfonull658 function FSCopyAliasInfo( inAlias: AliasHandle; targetName: HFSUniStr255Ptr { can be NULL }; volumeName: HFSUniStr255Ptr { can be NULL }; pathString: CFStringRefPtr { can be NULL }; whichInfo: FSAliasInfoBitmapPtr { can be NULL }; info: FSAliasInfoPtr { can be NULL } ): OSStatus; external name '_FSCopyAliasInfo';
659 (* __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_2, __MAC_10_8, __IPHONE_NA, __IPHONE_NA) *)
660
661
662 {
663 * GetAliasSize()
664 *
665 * Discussion:
666 * This routine will return the size of the alias record referenced
667 * by the AliasHandle alias. This will be smaller than the size
668 * returned by GetHandleSize if any custom data has been added (IM
669 * Files 4-13).
670 *
671 * Mac OS X threading:
672 * Thread safe since version 10.4
673 *
674 * Parameters:
675 *
676 * alias:
677 * A handle to the alias record to get the information from.
678 *
679 * Result:
680 * The size of the private section of the alias record.
681 *
682 * Availability:
683 * Mac OS X: in version 10.4 and later in CoreServices.framework
684 * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.4 and later
685 * Non-Carbon CFM: not available
686 }
GetAliasSizenull687 function GetAliasSize( alias: AliasHandle ): Size; external name '_GetAliasSize';
688 (* __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_4, __MAC_10_8, __IPHONE_NA, __IPHONE_NA) *)
689
690
691 {
692 * GetAliasUserType()
693 *
694 * Discussion:
695 * This routine will return the usertype associated with the alias
696 * record referenced by the AliasHandle alias.
697 *
698 * Mac OS X threading:
699 * Thread safe since version 10.4
700 *
701 * Parameters:
702 *
703 * alias:
704 * A handle to the alias record to get the userType from.
705 *
706 * Result:
707 * The userType associated with the alias as an OSType
708 *
709 * Availability:
710 * Mac OS X: in version 10.4 and later in CoreServices.framework
711 * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.4 and later
712 * Non-Carbon CFM: not available
713 }
GetAliasUserTypenull714 function GetAliasUserType( alias: AliasHandle ): OSType; external name '_GetAliasUserType';
715 (* __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_4, __MAC_10_8, __IPHONE_NA, __IPHONE_NA) *)
716
717
718 {
719 * SetAliasUserType()
720 *
721 * Discussion:
722 * This routine will set the userType associated with an alias
723 * record.
724 *
725 * Mac OS X threading:
726 * Thread safe since version 10.4
727 *
728 * Parameters:
729 *
730 * alias:
731 * A handle to the alias record to set the userType for.
732 *
733 * userType:
734 * The OSType to set the userType to.
735 *
736 * Availability:
737 * Mac OS X: in version 10.4 and later in CoreServices.framework
738 * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.4 and later
739 * Non-Carbon CFM: not available
740 }
741 procedure SetAliasUserType( alias: AliasHandle; userType: OSType ); external name '_SetAliasUserType';
742 (* __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_4, __MAC_10_8, __IPHONE_NA, __IPHONE_NA) *)
743
744
745 {
746 * GetAliasSizeFromPtr()
747 *
748 * Discussion:
749 * This routine will return the size of the alias record referenced
750 * by a pointer to the AliasRecord.
751 *
752 * Mac OS X threading:
753 * Thread safe since version 10.4
754 *
755 * Parameters:
756 *
757 * alias:
758 * A pointer to the alias record to get the information from.
759 *
760 * Result:
761 * The size of the private section of the alias record.
762 *
763 * Availability:
764 * Mac OS X: in version 10.4 and later in CoreServices.framework
765 * CarbonLib: not available
766 * Non-Carbon CFM: not available
767 }
GetAliasSizeFromPtrnull768 function GetAliasSizeFromPtr( const (*var*) alias: AliasRecord ): Size; external name '_GetAliasSizeFromPtr';
769 (* __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_4, __MAC_10_8, __IPHONE_NA, __IPHONE_NA) *)
770
771
772 {
773 * GetAliasUserTypeFromPtr()
774 *
775 * Discussion:
776 * This routine will return the usertype associated withthe alias
777 * record pointed to by alias.
778 *
779 * Mac OS X threading:
780 * Thread safe since version 10.4
781 *
782 * Parameters:
783 *
784 * alias:
785 * A pointer to the alias record to get the userType from.
786 *
787 * Result:
788 * The userType associated with the alias as an OSType
789 *
790 * Availability:
791 * Mac OS X: in version 10.4 and later in CoreServices.framework
792 * CarbonLib: not available
793 * Non-Carbon CFM: not available
794 }
GetAliasUserTypeFromPtrnull795 function GetAliasUserTypeFromPtr( const (*var*) alias: AliasRecord ): OSType; external name '_GetAliasUserTypeFromPtr';
796 (* __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_4, __MAC_10_8, __IPHONE_NA, __IPHONE_NA) *)
797
798
799 {
800 * SetAliasUserTypeWithPtr()
801 *
802 * Discussion:
803 * This routine will set the userType associated with an alias
804 * record.
805 *
806 * Mac OS X threading:
807 * Thread safe since version 10.4
808 *
809 * Parameters:
810 *
811 * alias:
812 * A pointer to the alias record to set the userType for.
813 *
814 * userType:
815 * The OSType to set the userType to.
816 *
817 * Availability:
818 * Mac OS X: in version 10.4 and later in CoreServices.framework
819 * CarbonLib: not available
820 * Non-Carbon CFM: not available
821 }
822 procedure SetAliasUserTypeWithPtr( alias: AliasPtr; userType: OSType ); external name '_SetAliasUserTypeWithPtr';
823 (* __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_4, __MAC_10_8, __IPHONE_NA, __IPHONE_NA) *)
824
825
826 { Functions beyond this point are deprecated}
827
828 {$ifc not TARGET_CPU_64}
829 {
830 * FSMatchAlias() *** DEPRECATED ***
831 *
832 * Deprecated:
833 * Use FSMatchAliasBulk instead
834 *
835 * Summary:
836 * Given an alias handle and fromFile, match the alias and return
837 * FSRefs to the aliased file(s) and needsUpdate flag
838 *
839 * Mac OS X threading:
840 * Thread safe since version 10.3
841 *
842 * Availability:
843 * Mac OS X: in version 10.2 and later in CoreServices.framework [32-bit only] but deprecated in 10.5
844 * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.2 and later
845 * Non-Carbon CFM: not available
846 }
FSMatchAliasnull847 function FSMatchAlias( {const} fromFile: FSRefPtr { can be NULL }; rulesMask: UNSIGNEDLONG; inAlias: AliasHandle; var aliasCount: SInt16; var aliasList: FSRef; var needsUpdate: Boolean; aliasFilter: AliasFilterUPP; yourDataPtr: UnivPtr ): OSErr; external name '_FSMatchAlias';
848 (* __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_2, __MAC_10_5, __IPHONE_NA, __IPHONE_NA) *)
849
850
851 {
852 * FSMatchAliasNoUI() *** DEPRECATED ***
853 *
854 * Deprecated:
855 * Use FSMatchAliasBulk with the kARMNoUI flag instead
856 *
857 * Summary:
858 * variation on FSMatchAlias that does not prompt user with a dialog
859 *
860 * Mac OS X threading:
861 * Thread safe since version 10.3
862 *
863 * Availability:
864 * Mac OS X: in version 10.2 and later in CoreServices.framework [32-bit only] but deprecated in 10.5
865 * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.2 and later
866 * Non-Carbon CFM: not available
867 }
FSMatchAliasNoUInull868 function FSMatchAliasNoUI( {const} fromFile: FSRefPtr { can be NULL }; rulesMask: UNSIGNEDLONG; inAlias: AliasHandle; var aliasCount: SInt16; var aliasList: FSRef; var needsUpdate: Boolean; aliasFilter: AliasFilterUPP; yourDataPtr: UnivPtr ): OSErr; external name '_FSMatchAliasNoUI';
869 (* __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_2, __MAC_10_5, __IPHONE_NA, __IPHONE_NA) *)
870
871
872 {
873 * NewAlias() *** DEPRECATED ***
874 *
875 * Deprecated:
876 * Use FSNewAlias
877 *
878 * Summary:
879 * create a new alias between fromFile and target, returns alias
880 * record handle
881 *
882 * Discussion:
883 * Create an alias betwen fromFile and target, and return it in an
884 * AliasHandle. This function is deprecated in Mac OS X 10.4;
885 * instead, you should use FSNewAliasUnicode() because NewAlias()
886 * has problems creating aliases to certain files, including those
887 * which are impossible to represent in an FSSpec.
888 *
889 * Mac OS X threading:
890 * Thread safe since version 10.3
891 *
892 * Availability:
893 * Mac OS X: in version 10.0 and later in CoreServices.framework [32-bit only] but deprecated in 10.4
894 * CarbonLib: in CarbonLib 1.0 and later
895 * Non-Carbon CFM: in InterfaceLib 7.1 and later
896 }
NewAliasnull897 function NewAlias( {const} fromFile: FSSpecPtr { can be NULL }; const (*var*) target: FSSpec; var alias: AliasHandle ): OSErr; external name '_NewAlias';
898 (* __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_0, __MAC_10_4, __IPHONE_NA, __IPHONE_NA) *)
899
900
901 {
902 * NewAliasMinimal() *** DEPRECATED ***
903 *
904 * Deprecated:
905 * Use FSNewAliasMinimalUnicode
906 *
907 * Summary:
908 * create a minimal new alias for a target and return alias record
909 * handle
910 *
911 * Discussion:
912 * Create a minimal alias for a target, and return it in an
913 * AliasHandle. This function is deprecated in Mac OS X 10.4;
914 * instead, you should use FSNewAliasMinimalUnicode() because
915 * NewAliasMinimalAlias() has problems creating aliases to certain
916 * files, including those which are impossible to represent in an
917 * FSSpec.
918 *
919 * Mac OS X threading:
920 * Thread safe since version 10.3
921 *
922 * Availability:
923 * Mac OS X: in version 10.0 and later in CoreServices.framework [32-bit only] but deprecated in 10.4
924 * CarbonLib: in CarbonLib 1.0 and later
925 * Non-Carbon CFM: in InterfaceLib 7.1 and later
926 }
NewAliasMinimalnull927 function NewAliasMinimal( const (*var*) target: FSSpec; var alias: AliasHandle ): OSErr; external name '_NewAliasMinimal';
928 (* __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_0, __MAC_10_4, __IPHONE_NA, __IPHONE_NA) *)
929
930
931 {
932 * NewAliasMinimalFromFullPath() *** DEPRECATED ***
933 *
934 * Deprecated:
935 * Use FSNewAliasMinimalUnicode
936 *
937 * Summary:
938 * create a minimal new alias from a target fullpath (optional zone
939 * and server name) and return alias record handle
940 *
941 * Discussion:
942 * Create a minimal alias for a target fullpath, and return it in an
943 * AliasHandle. This function is deprecated in Mac OS X 10.4;
944 * instead, you should use FSNewAliasMinimalUnicode() because
945 * NewAliasMinimalFromFullPath() has problems creating aliases to
946 * certain files, including those which are impossible to represent
947 * in an FSSpec.
948 *
949 * Mac OS X threading:
950 * Thread safe since version 10.3
951 *
952 * Availability:
953 * Mac OS X: in version 10.0 and later in CoreServices.framework [32-bit only] but deprecated in 10.4
954 * CarbonLib: in CarbonLib 1.0 and later
955 * Non-Carbon CFM: in InterfaceLib 7.1 and later
956 }
NewAliasMinimalFromFullPathnull957 function NewAliasMinimalFromFullPath( fullPathLength: SInt16; fullPath: {const} UnivPtr; const (*var*) zoneName: Str32; const (*var*) serverName: Str31; var alias: AliasHandle ): OSErr; external name '_NewAliasMinimalFromFullPath';
958 (* __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_0, __MAC_10_4, __IPHONE_NA, __IPHONE_NA) *)
959
960
961 {
962 * ResolveAlias() *** DEPRECATED ***
963 *
964 * Deprecated:
965 * Use FSResolveAlias() or FSResolveAliasWithMountFlags() instead.
966 *
967 * Summary:
968 * given an alias handle and fromFile, resolve the alias, update the
969 * alias record and return aliased filename and wasChanged flag.
970 *
971 * Mac OS X threading:
972 * Thread safe since version 10.3
973 *
974 * Availability:
975 * Mac OS X: in version 10.0 and later in CoreServices.framework [32-bit only] but deprecated in 10.4
976 * CarbonLib: in CarbonLib 1.0 and later
977 * Non-Carbon CFM: in InterfaceLib 7.1 and later
978 }
ResolveAliasnull979 function ResolveAlias( {const} fromFile: FSSpecPtr { can be NULL }; alias: AliasHandle; var target: FSSpec; var wasChanged: Boolean ): OSErr; external name '_ResolveAlias';
980 (* __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_0, __MAC_10_4, __IPHONE_NA, __IPHONE_NA) *)
981
982
983 {
984 * GetAliasInfo() *** DEPRECATED ***
985 *
986 * Deprecated:
987 * Use FSCopyAliasInfo instead.
988 *
989 * Summary:
990 * This call does not work on all aliases. Given an alias handle and
991 * an index specifying requested alias information type, return the
992 * information from alias record as a string. An empty string is
993 * returned when the index is greater than the number of levels
994 * between the target and root.
995 *
996 * Mac OS X threading:
997 * Thread safe since version 10.0
998 *
999 * Availability:
1000 * Mac OS X: in version 10.0 and later in CoreServices.framework [32-bit only] but deprecated in 10.3
1001 * CarbonLib: in CarbonLib 1.0 and later
1002 * Non-Carbon CFM: in InterfaceLib 7.1 and later
1003 }
GetAliasInfonull1004 function GetAliasInfo( alias: AliasHandle; itemIndex: AliasInfoType; var theString: Str63 ): OSErr; external name '_GetAliasInfo';
1005 (* __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_0, __MAC_10_3, __IPHONE_NA, __IPHONE_NA) *)
1006
1007
1008 {
1009 * IsAliasFile() *** DEPRECATED ***
1010 *
1011 * Deprecated:
1012 * Use FSIsAliasFile() instead.
1013 *
1014 * Summary:
1015 * Return true if the file pointed to by fileFSSpec is an alias file.
1016 *
1017 * Mac OS X threading:
1018 * Thread safe since version 10.0
1019 *
1020 * Availability:
1021 * Mac OS X: in version 10.0 and later in CoreServices.framework [32-bit only] but deprecated in 10.4
1022 * CarbonLib: in CarbonLib 1.0 and later
1023 * Non-Carbon CFM: in InterfaceLib 8.5 and later
1024 }
IsAliasFilenull1025 function IsAliasFile( const (*var*) fileFSSpec: FSSpec; var aliasFileFlag: Boolean; var folderFlag: Boolean ): OSErr; external name '_IsAliasFile';
1026 (* __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_0, __MAC_10_4, __IPHONE_NA, __IPHONE_NA) *)
1027
1028
1029 {
1030 * ResolveAliasWithMountFlags() *** DEPRECATED ***
1031 *
1032 * Deprecated:
1033 * Use FSResolveAliasWithMountFlags() instead.
1034 *
1035 * Summary:
1036 * Given an AliasHandle, return target file spec. It resolves the
1037 * entire alias chain or one step of the chain. It returns info
1038 * about whether the target is a folder or file; and whether the
1039 * input file spec was an alias or not.
1040 *
1041 * Mac OS X threading:
1042 * Thread safe since version 10.3
1043 *
1044 * Availability:
1045 * Mac OS X: in version 10.0 and later in CoreServices.framework [32-bit only] but deprecated in 10.4
1046 * CarbonLib: in CarbonLib 1.0 and later
1047 * Non-Carbon CFM: in InterfaceLib 8.5 and later
1048 }
ResolveAliasWithMountFlagsnull1049 function ResolveAliasWithMountFlags( {const} fromFile: FSSpecPtr { can be NULL }; alias: AliasHandle; var target: FSSpec; var wasChanged: Boolean; mountFlags: UNSIGNEDLONG ): OSErr; external name '_ResolveAliasWithMountFlags';
1050 (* __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_0, __MAC_10_4, __IPHONE_NA, __IPHONE_NA) *)
1051
1052
1053 {
1054 * ResolveAliasFile() *** DEPRECATED ***
1055 *
1056 * Deprecated:
1057 * Use FSResolveAliasFile
1058 *
1059 * Summary:
1060 * Given a file spec, return target file spec if input file spec is
1061 * an alias. It resolves the entire alias chain or one step of the
1062 * chain. It returns info about whether the target is a folder or
1063 * file; and whether the input file spec was an alias or not.
1064 *
1065 * Mac OS X threading:
1066 * Thread safe since version 10.3
1067 *
1068 * Availability:
1069 * Mac OS X: in version 10.0 and later in CoreServices.framework [32-bit only] but deprecated in 10.4
1070 * CarbonLib: in CarbonLib 1.0 and later
1071 * Non-Carbon CFM: in InterfaceLib 7.1 and later
1072 }
ResolveAliasFilenull1073 function ResolveAliasFile( var theSpec: FSSpec; resolveAliasChains: Boolean; var targetIsFolder: Boolean; var wasAliased: Boolean ): OSErr; external name '_ResolveAliasFile';
1074 (* __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_0, __MAC_10_4, __IPHONE_NA, __IPHONE_NA) *)
1075
1076
1077 { Deprecated: Use FSResolveAliasFileWithMountFlags instead}
1078 {
1079 * ResolveAliasFileWithMountFlags() *** DEPRECATED ***
1080 *
1081 * Mac OS X threading:
1082 * Thread safe since version 10.3
1083 *
1084 * Availability:
1085 * Mac OS X: in version 10.0 and later in CoreServices.framework [32-bit only] but deprecated in 10.5
1086 * CarbonLib: in CarbonLib 1.0 and later
1087 * Non-Carbon CFM: in InterfaceLib 8.5 and later
1088 }
ResolveAliasFileWithMountFlagsnull1089 function ResolveAliasFileWithMountFlags( var theSpec: FSSpec; resolveAliasChains: Boolean; var targetIsFolder: Boolean; var wasAliased: Boolean; mountFlags: UNSIGNEDLONG ): OSErr; external name '_ResolveAliasFileWithMountFlags';
1090 (* __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_0, __MAC_10_5, __IPHONE_NA, __IPHONE_NA) *)
1091
1092
1093 { Deprecated: Use FSFollowFinderAlias instead}
1094 {
1095 * FollowFinderAlias() *** DEPRECATED ***
1096 *
1097 * Mac OS X threading:
1098 * Thread safe since version 10.3
1099 *
1100 * Availability:
1101 * Mac OS X: in version 10.0 and later in CoreServices.framework [32-bit only] but deprecated in 10.5
1102 * CarbonLib: in CarbonLib 1.0 and later
1103 * Non-Carbon CFM: in InterfaceLib 8.5 and later
1104 }
FollowFinderAliasnull1105 function FollowFinderAlias( {const} fromFile: FSSpecPtr { can be NULL }; alias: AliasHandle; logon: Boolean; var target: FSSpec; var wasChanged: Boolean ): OSErr; external name '_FollowFinderAlias';
1106 (* __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_0, __MAC_10_5, __IPHONE_NA, __IPHONE_NA) *)
1107
1108
1109 {
1110 Low Level Routines
1111 }
1112 {
1113 * UpdateAlias() *** DEPRECATED ***
1114 *
1115 * Deprecated:
1116 * UseFSUpdateAlias
1117 *
1118 * Summary:
1119 * given a fromFile-target pair and an alias handle, update the
1120 * alias record pointed to by alias handle to represent target as
1121 * the new alias.
1122 *
1123 * Mac OS X threading:
1124 * Thread safe since version 10.3
1125 *
1126 * Availability:
1127 * Mac OS X: in version 10.0 and later in CoreServices.framework [32-bit only] but deprecated in 10.4
1128 * CarbonLib: in CarbonLib 1.0 and later
1129 * Non-Carbon CFM: in InterfaceLib 7.1 and later
1130 }
UpdateAliasnull1131 function UpdateAlias( {const} fromFile: FSSpecPtr { can be NULL }; const (*var*) target: FSSpec; alias: AliasHandle; var wasChanged: Boolean ): OSErr; external name '_UpdateAlias';
1132 (* __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_0, __MAC_10_4, __IPHONE_NA, __IPHONE_NA) *)
1133
1134
1135 {
1136 * MatchAlias() *** DEPRECATED ***
1137 *
1138 * Deprecated:
1139 * Use FSMatchAliasBulk instead
1140 *
1141 * Summary:
1142 * Given an alias handle and fromFile, match the alias and return
1143 * FSSpecs to the aliased file(s) and needsUpdate flag
1144 *
1145 * Mac OS X threading:
1146 * Thread safe since version 10.3
1147 *
1148 * Availability:
1149 * Mac OS X: in version 10.0 and later in CoreServices.framework [32-bit only] but deprecated in 10.4
1150 * CarbonLib: in CarbonLib 1.0 and later
1151 * Non-Carbon CFM: in InterfaceLib 7.1 and later
1152 }
MatchAliasnull1153 function MatchAlias( {const} fromFile: FSSpecPtr { can be NULL }; rulesMask: UNSIGNEDLONG; alias: AliasHandle; var aliasCount: SInt16; aliasList: FSSpecArrayPtr; var needsUpdate: Boolean; aliasFilter: AliasFilterUPP; yourDataPtr: UnivPtr ): OSErr; external name '_MatchAlias';
1154 (* __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_0, __MAC_10_4, __IPHONE_NA, __IPHONE_NA) *)
1155
1156
1157 {
1158 * ResolveAliasFileWithMountFlagsNoUI() *** DEPRECATED ***
1159 *
1160 * Deprecated:
1161 * Use FSResolveAliasFileWithMountFlags passing in the
1162 * kResolveAliasFileNoUI flag
1163 *
1164 * Summary:
1165 * variation on ResolveAliasFile that does not prompt user with a
1166 * dialog
1167 *
1168 * Mac OS X threading:
1169 * Thread safe since version 10.3
1170 *
1171 * Availability:
1172 * Mac OS X: in version 10.0 and later in CoreServices.framework [32-bit only] but deprecated in 10.4
1173 * CarbonLib: in CarbonLib 1.0 and later
1174 * Non-Carbon CFM: not available
1175 }
ResolveAliasFileWithMountFlagsNoUInull1176 function ResolveAliasFileWithMountFlagsNoUI( var theSpec: FSSpec; resolveAliasChains: Boolean; var targetIsFolder: Boolean; var wasAliased: Boolean; mountFlags: UNSIGNEDLONG ): OSErr; external name '_ResolveAliasFileWithMountFlagsNoUI';
1177 (* __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_0, __MAC_10_4, __IPHONE_NA, __IPHONE_NA) *)
1178
1179
1180 {
1181 * MatchAliasNoUI() *** DEPRECATED ***
1182 *
1183 * Deprecated:
1184 * Use FSMatchAliasBulk with the kARMNoUI flag instead
1185 *
1186 * Summary:
1187 * variation on MatchAlias that does not prompt user with a dialog
1188 *
1189 * Mac OS X threading:
1190 * Thread safe since version 10.3
1191 *
1192 * Availability:
1193 * Mac OS X: in version 10.0 and later in CoreServices.framework [32-bit only] but deprecated in 10.5
1194 * CarbonLib: in CarbonLib 1.0 and later
1195 * Non-Carbon CFM: not available
1196 }
MatchAliasNoUInull1197 function MatchAliasNoUI( {const} fromFile: FSSpecPtr { can be NULL }; rulesMask: UNSIGNEDLONG; alias: AliasHandle; var aliasCount: SInt16; aliasList: FSSpecArrayPtr; var needsUpdate: Boolean; aliasFilter: AliasFilterUPP; yourDataPtr: UnivPtr ): OSErr; external name '_MatchAliasNoUI';
1198 (* __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_0, __MAC_10_5, __IPHONE_NA, __IPHONE_NA) *)
1199
1200
1201
1202 {$endc} {not TARGET_CPU_64}
1203
1204 {$endc} {TARGET_OS_MAC}
1205
1206 {$ifc not defined MACOSALLINCLUDE or not MACOSALLINCLUDE}
1207
1208 end.
1209 {$endc} {not MACOSALLINCLUDE}
1210