Исказите ссылку менеджера

Менеджер по Псевдониму включает создание и разрешение записей псевдонима, которые являются структурами данных, описывающими файлы, каталоги и объемы в файловой системе. Запись псевдонима содержит «цифровой отпечаток» объекта файловой системы. Можно сохранить запись псевдонима вместо ссылки файловой системы и использовать менеджера по Псевдониму для нахождения объекта снова, когда это необходимо. Менеджер по Псевдониму содержит алгоритмы для определения местоположения объектов, перемещенных, переименованных, скопированных или восстановленных от резервного копирования.

Точный состав записи псевдонима зависит от файловой системы, в которой находится объект. Менеджер по Псевдониму использует в своих интересах идентификаторы постоянного объекта, даты создания, типы файлов, коды создателя и т.п., если они доступны. По умолчанию объект в расположении, сохраненном в записи псевдонима, будут считать более сильным соответствием, чем объект с тем же идентификатором файла в различном расположении. (Можно изменить это поведение путем передачи флагов функциям, разрешающим псевдоним.)

Менеджер по Псевдониму поддерживает два типа записей псевдонима. Стандартный псевдоним содержит столько информации, сколько менеджер по Псевдониму может собрать из базовой файловой системы. Минимальный псевдоним только хранит подмножество информации в стандартной записи псевдонима. Минимальный псевдоним может использоваться, когда объект вряд ли переместится, ссылка должна быть недолгой, или пространство является критической проблемой (точные сбережения пространства зависит от базового формата файловой системы.) Стандартный псевдоним является предпочтительным форматом, потому что это более устойчиво.

Средство поиска поддерживает создание и использование файлов псевдонима, содержащих записи псевдонима. В настоящее время OS X не обеспечивает путь к другим приложениям для создания этих файлов псевдонима. Менеджер по Псевдониму может идентифицировать и разрешить файлы псевдонима Средства поиска, но это не может создать их.

Функции

Создание и обновление записей псевдонима


    
    FSNewAlias
    FSNewAlias

(OS X v10.8)

Создает новую запись псевдонима, учитывая конечный файл или каталог.

Оператор осуждения

Использовать CFURLCreateBookmarkData вместо этого.

Объявление

Objective C

OSErr FSNewAlias ( const FSRef *fromFile, const FSRef *target, AliasHandle *inAlias );

Параметры

`fromFile`	Указатель на начальную точку для относительного поиска. Можно передать `NULL` если Вам не нужна относительная поисковая информация в записи псевдонима. Файлы или каталоги, указанные в `fromFile` и `target` параметры должны находиться на том же объеме.
`target`	Указатель на конечный файл или каталог псевдонима.
`inAlias`	Указатель на дескриптор псевдонима. По возврату этот дескриптор относится к недавно создаваемой записи псевдонима. Если функции не удается создать запись псевдонима, она устанавливает `inAlias` к `NULL`.

Возвращаемое значение

Код результата. Если указанная цель допустима, эта функция создает запись псевдонима для цели и возвратов noErr. Любое другое возвращаемое значение указывает, что эта функция не создавала запись псевдонима.

Обсуждение

FSNewAlias функция создает запись псевдонима, описывающую указанную цель. Это выделяет хранение, заполняет запись и помещает рекордный дескриптор в то хранение в inAlias параметр. FSNewAlias записывает полный путь цели и набор другой информации, относящейся к определению местоположения цели, проверке цели и монтированию объема цели, при необходимости. Вы можете иметь FSNewAlias храните относительную поисковую информацию также путем предоставления начальной точки для относительного поиска.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    FSNewAliasUnicode
    FSNewAliasUnicode

(OS X v10.8)

Создает новую запись псевдонима, учитывая имя Unicode и родительский каталог цели.

Оператор осуждения

Использовать CFURLCreateBookmarkData вместо этого.

Объявление

Objective C

OSErr FSNewAliasUnicode ( const FSRef *fromFile, const FSRef *targetParentRef, UniCharCount targetNameLength, const UniChar *targetName, AliasHandle *inAlias, Boolean *isDirectory );

Параметры

`fromFile`	Указатель на начальную точку для относительного поиска. Можно передать `NULL` если Вам не нужна относительная поисковая информация в записи псевдонима.
`targetParentRef`	Указатель на родительский каталог цели.
`targetNameLength`	Число символов Unicode на имя цели.
`targetName`	Указатель на имя Unicode цели.
`inAlias`	Указатель на дескриптор псевдонима. По возврату этот обработчик относится к недавно создаваемой записи псевдонима.
`isDirectory`	Указатель на булево значение. На вводе, если цель не существует, устанавливает значение в `true` если цель является каталогом или `false` если это не. (Передача `NULL` если Вы не уверены, является ли цель каталогом.) На выводе, если цель существует, значение `true` если цель является каталогом, `false` если это не.

Возвращаемое значение

Код результата. Для получения дополнительной информации посмотрите Обсуждение.

Обсуждение

Если указанная цель существует, эта функция создает запись псевдонима для цели и возвратов noErr. Если родительский каталог существует, но сама цель не существует, эта функция создает запись псевдонима для цели и возвратов fnfErr. Любое другое возвращаемое значение указывает, что эта функция не создавала запись псевдонима.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.2 и позже.

Осуждаемый в OS X v10.8.


    
    FSNewAliasFromPath
    FSNewAliasFromPath

(OS X v10.8)

Создает новую запись псевдонима, учитывая путь конечного файла или каталога.

Оператор осуждения

Использовать CFURLCreateBookmarkData вместо этого.

Объявление

Objective C

OSStatus FSNewAliasFromPath ( const char *fromFilePath, const char *targetPath, OptionBits flags, AliasHandle *inAlias, Boolean *isDirectory );

Параметры

`fromFilePath`	Струна до, указывающая начальную точку для относительного поиска. Строка должна содержать путь UTF-8. Можно передать `NULL` если Вам не нужна относительная поисковая информация в записи псевдонима.
`targetPath`	Струна до, содержащая полный путь UTF-8 целевого объекта.
`flags`	Зарезервированный для будущего использования. В настоящее время необходимо передать 0.
`inAlias`	Указатель на дескриптор псевдонима. На выводе этот дескриптор относится к недавно создаваемой записи псевдонима.
`isDirectory`	Указатель на булево значение. На вводе, если цель не существует, устанавливает значение в `true` если цель является каталогом или `false` если это не. (Передача `NULL` если Вы не уверены, является ли цель каталогом.) На выводе, если цель существует, значение `true` если цель является каталогом, `false` если это не.

Возвращаемое значение

Код результата. Для получения дополнительной информации посмотрите Обсуждение.

Обсуждение

Если указанная цель существует, эта функция создает запись псевдонима для цели и возвратов noErr. Если родительский каталог, указанный в целевом пути, существует, но сама цель не существует, эта функция создает запись псевдонима для цели и возвратов fnfErr. Любое другое возвращаемое значение указывает, что эта функция не создавала запись псевдонима.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.5 и позже.

Осуждаемый в OS X v10.8.


    
    FSNewAliasMinimal
    FSNewAliasMinimal

(OS X v10.8)

Создает новую минимальную запись псевдонима, учитывая конечный файл или каталог.

Оператор осуждения

Использовать CFURLCreateBookmarkData вместо этого.

Объявление

Objective C

OSErr FSNewAliasMinimal ( const FSRef *target, AliasHandle *inAlias );

Параметры

`target`	Указатель на цель записи псевдонима.
`inAlias`	Указатель на дескриптор псевдонима. По возврату этот дескриптор относится к недавно создаваемой записи псевдонима. Если функции не удается создать запись псевдонима, она устанавливает `inAlias` к `NULL`.

Возвращаемое значение

Обсуждение

FSNewAliasMinimal функция создает запись псевдонима, содержащую только минимальную информацию, необходимую для описания цели. FSNewAliasMinimal функционируйте использует стандартную структуру данных записи псевдонима, но она заполняет только части записи.

FSResolveAlias функционируйте никогда не обновляет минимальную запись псевдонима.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    FSNewAliasMinimalUnicode
    FSNewAliasMinimalUnicode

(OS X v10.8)

Создает минимальный псевдоним, учитывая имя Unicode и родительский каталог цели.

Оператор осуждения

Использовать CFURLCreateBookmarkData вместо этого.

Объявление

Objective C

OSErr FSNewAliasMinimalUnicode ( const FSRef *targetParentRef, UniCharCount targetNameLength, const UniChar *targetName, AliasHandle *inAlias, Boolean *isDirectory );

Параметры

`targetParentRef`	Указатель на родительский каталог цели.
`targetNameLength`	Число символов Unicode на имя цели.
`targetName`	Указатель на имя Unicode цели.
`inAlias`	Указатель на дескриптор псевдонима. По возврату этот дескриптор относится к недавно создаваемой записи псевдонима.
`isDirectory`	Указатель на булево значение. На вводе, если цель не существует, устанавливает значение в `true` если цель является каталогом или `false` если это не. (Передача `NULL` если Вы не уверены, является ли цель каталогом.) На выводе, если цель существует, значение `true` если цель является каталогом, `false` если это не.

Возвращаемое значение

Код результата. Для получения дополнительной информации посмотрите Обсуждение.

Обсуждение

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.2 и позже.

Осуждаемый в OS X v10.8.


    
    FSUpdateAlias
    FSUpdateAlias

(OS X v10.8)

Обновляет запись псевдонима для указанной цели.

Оператор осуждения

Сначала используйте CFURLCreateBookmarkData, тогда используйте CFURLWriteBookmarkDataToFile.

Объявление

Objective C

OSErr FSUpdateAlias ( const FSRef *fromFile, const FSRef *target, AliasHandle alias, Boolean *wasChanged );

Параметры

`fromFile`	Указатель на начальную точку для относительного поиска. Можно передать `NULL` если Вам не нужна относительная поисковая информация в записи псевдонима. Эти два файла или каталога, указанные в `fromFile` и `target` параметры должны находиться на том же объеме.
`target`	Указатель на цель записи псевдонима.
`alias`	Дескриптор к псевдониму записывает, чтобы быть обновленным.
`wasChanged`	Указатель на булево значение, на выводе, указывающее, отличается ли недавно созданная запись псевдонима от старой. Если новая запись является точно тем же как старым, значение `false`. Иначе, значение `true`. Проверьте этот параметр, чтобы определить, необходимо ли сохранить обновленную запись.

Возвращаемое значение

Код результата.

Обсуждение

Эта функция восстанавливает всю запись псевдонима и заполняет ее как FSNewAlias функция была бы. FSUpdateAlias функция всегда создает полную запись псевдонима. Когда Вы используете FSUpdateAlias для обновления минимальной записи псевдонима Вы преобразовываете минимальную запись на полную запись.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.

Получение размера псевдонима


    
    GetAliasSize
    GetAliasSize

(OS X v10.8)

Получает размер записи псевдонима, на которую ссылается дескриптор.

Оператор осуждения

Использовать CFDataGetLength, передача в данных закладки.

Объявление

Objective C

Size GetAliasSize ( AliasHandle alias );

Параметры


      alias

Дескриптор к псевдониму записывает, от которого можно получить информацию.

Возвращаемое значение

Размер записи псевдонима.

Обсуждение

Возвращенный размер меньше, чем размер, возвращенный функцией GetHandleSize если добавляются какие-либо пользовательские данные. Эта подпрограмма ориентирована на многопотоковое исполнение.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.4 и позже.

Осуждаемый в OS X v10.8.


    
    GetAliasSizeFromPtr
    GetAliasSizeFromPtr

(OS X v10.8)

Получает размер записи псевдонима, на которую ссылается указатель.

Оператор осуждения

Использовать CFDataGetLength, передача в данных закладки.

Объявление

Objective C

Size GetAliasSizeFromPtr ( const AliasRecord *alias );

Параметры


      alias

Указатель на псевдоним записывает, от которого можно получить информацию.

Возвращаемое значение

Размер записи псевдонима.

Обсуждение

Эта подпрограмма ориентирована на многопотоковое исполнение.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.4 и позже.

Осуждаемый в OS X v10.8.

Получение и установка пользовательских типов псевдонима


    
    GetAliasUserType
    GetAliasUserType

(OS X v10.8)

Получает пользовательский тип для записи псевдонима, на которую ссылается дескриптор.

Оператор осуждения

Использовать CFURLSetTemporaryResourcePropertyForKey установить Ваши собственные временные свойства на объекте CFURL. Затем для встраивания этих свойств в данные закладки передайте свойства в resourcePropertiesToInclude параметр CFURLCreateBookmarkData. Для предотвращения конфликтов рекомендуется создать обратные имена DNS для временных строк ключа свойства.

Объявление

Objective C

OSType GetAliasUserType ( AliasHandle alias );

Параметры


      alias

Дескриптор к псевдониму записывает, от которого можно получить пользовательский тип.

Возвращаемое значение

Пользовательский тип связался с псевдонимом.

Обсуждение

Эта подпрограмма ориентирована на многопотоковое исполнение.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.4 и позже.

Осуждаемый в OS X v10.8.


    
    SetAliasUserType
    SetAliasUserType

(OS X v10.8)

Устанавливает пользовательский тип для записи псевдонима, на которую ссылается дескриптор.

Оператор осуждения

Объявление

Objective C

void SetAliasUserType ( AliasHandle alias, OSType userType );

Параметры

`alias`	Дескриптор к псевдониму записывает, для которого можно установить пользовательский тип.
`userType`	Пользовательский тип связался с псевдонимом.

Обсуждение

Эта подпрограмма ориентирована на многопотоковое исполнение.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.4 и позже.

Осуждаемый в OS X v10.8.


    
    GetAliasUserTypeFromPtr
    GetAliasUserTypeFromPtr

(OS X v10.8)

Получает пользовательский тип для записи псевдонима, на которую ссылается указатель.

Оператор осуждения

Объявление

Objective C

OSType GetAliasUserTypeFromPtr ( const AliasRecord *alias );

Параметры


      alias

Указатель на псевдоним записывает, от которого можно получить пользовательский тип.

Возвращаемое значение

Пользовательский тип связался с псевдонимом.

Обсуждение

Эта подпрограмма ориентирована на многопотоковое исполнение.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.4 и позже.

Осуждаемый в OS X v10.8.


    
    SetAliasUserTypeWithPtr
    SetAliasUserTypeWithPtr

(OS X v10.8)

Устанавливает пользовательский тип для записи псевдонима, на которую ссылается указатель.

Оператор осуждения

Объявление

Objective C

void SetAliasUserTypeWithPtr ( AliasPtr alias, OSType userType );

Параметры

`alias`	Указатель на псевдоним записывает, для которого можно установить пользовательский тип.
`userType`	Пользовательский тип связался с псевдонимом.

Обсуждение

Эта подпрограмма ориентирована на многопотоковое исполнение.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.4 и позже.

Осуждаемый в OS X v10.8.

Разрешение и чтение записей псевдонима


    
    FSCopyAliasInfo
    FSCopyAliasInfo

(OS X v10.8)

Информация о возвратах от дескриптора псевдонима.

Оператор осуждения

Использовать CFURLCreateResourcePropertiesForKeysFromBookmarkData или CFURLCreateResourcePropertyForKeyFromBookmarkData.

Объявление

Objective C

OSStatus FSCopyAliasInfo ( AliasHandle inAlias, HFSUniStr255 *targetName, HFSUniStr255 *volumeName, CFStringRef *pathString, FSAliasInfoBitmap *whichInfo, FSAliasInfo *info );

Параметры

`inAlias`	Дескриптор к псевдониму записывает, от которого можно получить информацию.
`targetName`	Указатель на строку, что, по возврату, содержит имя целевого элемента. Передача `NULL` если Вы не хотите эту возвращенную информацию.
`volumeName`	Указатель на строку, по возврату, содержащую имя объема цель, находится на. Передача `NULL` если Вы не хотите эту возвращенную информацию.
`pathString`	Указатель CFString, что, по возврату, содержит путь POSIX к цели. Передача `NULL` если Вы не хотите эту возвращенную информацию.
`whichInfo`	Указатель на переменную типа `FSAliasInfoBitmap`. По возврату это поле указывает который поля в блоке информации псевдонима, указанном в `info` параметр, содержите допустимые данные. Посмотрите Маски информации о Псевдониме для описания значений, которые могут быть возвращены сюда. Этот параметр может быть `NULL`.
`info`	Указатель на структуру типа `FSAliasInfo`. По возврату эта структура содержит информацию о псевдониме. Передача `NULL` если Вы не хотите эту возвращенную информацию.

Возвращаемое значение

Код результата.

Обсуждение

Эта функция возвращается, запрошенная информация от дескриптора псевдонима передала в inAlias параметр. Информация собирается только от записи псевдонима, таким образом, это может не соответствовать то, что находится на диске. Никакой дисковый ввод/вывод не выполняется.

FSCopyAliasInfo функция добавляет поддержку unicode имен файлов и имен файлов дольше, чем 32 байта. Это заменяет GetAliasInfo функция.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.2 и позже.

Осуждаемый в OS X v10.8.


    
    FSMatchAliasBulk
    FSMatchAliasBulk

(OS X v10.8)

Идентифицирует список возможных соответствий для псевдонима.

Оператор осуждения

Этот API не масштабируется к объемам, содержащим большие количества объектов файловой системы. Для поиска файлов, соответствующих определенные свойства используйте функциональность Центра внимания вместо этого (для узнавания больше о Центре внимания, см. Обзор Центра внимания).

Объявление

Objective C

OSStatus FSMatchAliasBulk ( const FSRef *fromFile, unsigned long rulesMask, AliasHandle inAlias, short *aliasCount, FSRef *aliasList, Boolean *needsUpdate, FSAliasFilterProcPtr aliasFilter, void *yourDataPtr );

Параметры

`fromFile`	Указатель на начальную точку для относительного поиска. Можно передать `NULL` если Вы не хотите, чтобы эта функция выполнила относительный поиск. По умолчанию эта функция выполняет относительный поиск, только если абсолютный поиск не находит соответствие. Если Вы хотите выполнить относительный поиск сначала, необходимо передать `kARMSearchRelFirst` в `rulesMask` параметр.
`rulesMask`	Ряд правил для руководства разрешения. Передайте сумму всех правил, которые Вы хотите вызвать. Для описания значений можно использовать в этом параметре, видеть Соответствие Констант.
`inAlias`	Дескриптор к псевдониму записывает, чтобы быть разрешенным.
`aliasCount`	На вводе, указателе на максимальное количество возможных соответствий для возврата. На выводе возвратилось фактическое число соответствий.
`aliasList`	Указатель на массив `FSRef` структуры. На выводе этот массив содержит результаты поиска, список возможных кандидатов.
`needsUpdate`	Указатель на булев флаг, на выводе, указывающий, должна ли быть обновлена запись псевдонима. Для получения дополнительной информации об этом параметре, посмотрите Обсуждение.
`aliasFilter`	Дополнительная определенная с помощью приложения функция фильтра. Вызовы диспетчера Псевдонима Ваш фильтр функционирует каждый раз, он идентифицирует возможное соответствие или после того, как поиск продолжался в течение трех секунд без соответствия. Ваша функция фильтра возвращает булево значение, определяющее, отбрасывается ли возможное соответствие (`true`) или добавил к списку возможных целей (`false`). Это может также завершить поиск путем установки переменного параметра `quitFlag`. Посмотрите `FSAliasFilterProcPtr` для описания функции фильтра.
`yourDataPtr`	Указатель на данные, которые будут переданы функции фильтра, или `NULL`. `yourDataPtr` параметр может указать на любые данные, в которых Ваше приложение, возможно, нуждалось бы в функции фильтра.

Возвращаемое значение

Код результата. Если менеджер по Псевдониму находит указанный объем и родительский каталог, но не удается найти конечный файл или каталог в том расположении, возвращаемое значение fnfErr и элементы в aliasList параметр не допустим.

Обсуждение

После того, как это идентифицирует цель, эта функция сравнивает некоторую ключевую информацию о цели с той же информацией в записи. Если информация не соответствует, эта функция устанавливает needsUpdate флаг к true. Эта функция также устанавливает needsUpdate флаг к true если это идентифицирует список возможных соответствий, а не единственного соответствия или если kARMsearchRelFirst установлен в rulesMask параметр, но цель идентифицируется или посредством абсолютного поиска или посредством исчерпывающего поиска. Иначе, эта функция устанавливает needsUpdate флаг к false. Эта функция всегда устанавливает needsUpdate флаг к false при разрешении псевдонима, создаваемого FSNewAliasMinimal. Для обновления записи псевдонима для отражения конечных результатов разрешения используйте функцию FSUpdateAlias.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.5 и позже.

Осуждаемый в OS X v10.8.


    
    FSMatchAlias
    FSMatchAlias

(OS X v10.5)

Идентифицирует список возможных соответствий для псевдонима.

Оператор осуждения

Использовать FSMatchAliasBulk вместо этого.

Объявление

Objective C

OSErr FSMatchAlias ( const FSRef *fromFile, unsigned long rulesMask, AliasHandle inAlias, short *aliasCount, FSRef *aliasList, Boolean *needsUpdate, AliasFilterUPP aliasFilter, void *yourDataPtr );

Параметры

`fromFile`	Указатель на начальную точку для относительного поиска. Можно передать `NULL` если Вы не хотите, чтобы эта функция выполнила относительный поиск.
`rulesMask`	Ряд правил для руководства разрешения. Передайте сумму всех правил, которые Вы хотите вызвать. Для описания значений можно использовать в этом параметре, видеть Соответствие Констант.
`inAlias`	Дескриптор к псевдониму записывает, чтобы быть разрешенным.
`aliasCount`	На вводе, указателе на максимальное количество возможных соответствий для возврата. На выводе возвратилось фактическое число соответствий.
`aliasList`	Указатель на массив `FSRef` структуры. По возврату этот массив содержит результаты поиска, список возможных кандидатов.
`needsUpdate`	Указатель на булев флаг, по возврату, указывающий, должна ли быть обновлена запись псевдонима.
`aliasFilter`	Определенная с помощью приложения функция фильтра. Менеджер по Псевдониму выполняет эту функцию каждый раз, когда она идентифицирует возможное соответствие. Ваша функция фильтра возвращает булево значение, определяющее, отбрасывается ли возможное соответствие (`true`) или добавил к списку возможных целей (`false`). Это может также завершить поиск путем установки переменного параметра `quitFlag`. Посмотрите `FSAliasFilterProcPtr` для описания функции фильтра.
`yourDataPtr`	Указатель на данные, которые будут переданы функции фильтра. `yourDataPtr` параметр может указать на любые данные, в которых Ваше приложение, возможно, нуждалось бы в функции фильтра.

Возвращаемое значение

Код результата. Когда это находит указанный объем и родительский каталог, но не удается найти конечный файл или каталог в том расположении, FSMatchAlias возвраты fnfErr. Обратите внимание на то, что файловая система возражает в aliasList параметр не допустим в этом случае.

Обсуждение

После того, как это идентифицирует цель, FSMatchAlias сравнивает некоторую ключевую информацию о цели с той же информацией в записи. Если информация не соответствует, FSMatchAlias наборы needsUpdate флаг к true.

FSMatchAlias функционируйте также устанавливает needsUpdate флаг к true если это идентифицирует список возможных соответствий, а не единственного соответствия или если kARMsearchRelFirst установлен в rulesMask параметр, но цель идентифицируется или посредством абсолютного поиска или посредством исчерпывающего поиска. Иначе, FSMatchAlias функционируйте устанавливает needsUpdate флаг к false. FSMatchAlias всегда наборы needsUpdate флаг к false при разрешении псевдонима, создаваемого FSNewAliasMinimal. Если Вы хотите обновить запись псевдонима для отражения конечных результатов разрешения, вызвать FSUpdateAlias.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.2 и позже.

Осуждаемый в OS X v10.5.

Не доступный 64-разрядным приложениям.


    
    FSMatchAliasNoUI
    FSMatchAliasNoUI

(OS X v10.5)

Идентифицирует список возможных соответствий для псевдонима без любого взаимодействия с пользователем.

Оператор осуждения

Использовать FSMatchAliasBulk с kARMNoUI флаг вместо этого.

Объявление

Objective C

OSErr FSMatchAliasNoUI ( const FSRef *fromFile, unsigned long rulesMask, AliasHandle inAlias, short *aliasCount, FSRef *aliasList, Boolean *needsUpdate, AliasFilterUPP aliasFilter, void *yourDataPtr );

Параметры

`fromFile`	Указатель на начальную точку для относительного поиска. Можно передать `NULL` если Вы не хотите, чтобы эта функция выполнила относительный поиск.
`rulesMask`	Ряд правил для руководства разрешения. Передайте сумму всех правил, которые Вы хотите вызвать. Для описания значений можно использовать в этом параметре, видеть Соответствие Констант.
`inAlias`	Дескриптор к псевдониму записывает, чтобы быть разрешенным.
`aliasCount`	На вводе, указателе на максимальное количество возможных соответствий для возврата. На выводе возвратилось фактическое число соответствий.
`aliasList`	Указатель на массив `FSRef` структуры. По возврату этот массив содержит результаты поиска, список возможных кандидатов.
`needsUpdate`	Указатель на булев флаг, по возврату, указывающий, должна ли быть обновлена запись псевдонима.
`aliasFilter`	Определенная с помощью приложения функция фильтра. Менеджер по Псевдониму выполняет эту функцию каждый раз, когда она идентифицирует возможное соответствие. Ваша функция фильтра возвращает булево значение, определяющее, отбрасывается ли возможное соответствие (`true`) или добавил к списку возможных целей (`false`). Это может также завершить поиск путем установки переменного параметра `quitFlag`. Посмотрите `FSAliasFilterProcPtr` для описания функции фильтра.
`yourDataPtr`	Указатель на данные, которые будут переданы функции фильтра. `yourDataPtr` параметр может указать на любые данные, в которых Ваше приложение, возможно, нуждалось бы в функции фильтра.

Возвращаемое значение

Код результата.

Обсуждение

FSMatchAliasNoUI функция действует почти таким же способом в качестве FSMatchAlias функция; однако, это не представляет интерфейс пользователю. Кроме того, FSMatchAliasNoUI функция не монтирует сетевые тома, даже когда возможно смонтировать объем без взаимодействия с пользователем. Посмотрите обсуждение FSMatchAlias для получения дополнительной информации.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.2 и позже.

Осуждаемый в OS X v10.5.

Не доступный 64-разрядным приложениям.


    
    FSResolveAlias
    FSResolveAlias

(OS X v10.8)

Возвраты FSRef к единственной наиболее вероятной цели записи псевдонима.

Оператор осуждения

Использовать CFURLCreateByResolvingBookmarkData вместо этого.

Объявление

Objective C

OSErr FSResolveAlias ( const FSRef *fromFile, AliasHandle alias, FSRef *target, Boolean *wasChanged );

Параметры

`fromFile`	Указатель на начальную точку для относительного поиска. Если Вы передаете `NULL` в этом параметре, `FSResolveAlias` выполняет только абсолютный поиск. Если Вы передаете указатель на допустимое `FSRef` в `fromFile` параметр, `FSResolveAlias` выполняет относительный поиск цели, сопровождаемой абсолютным поиском, только если относительный поиск перестал работать. Если Вы хотите выполнить абсолютный поиск, сопровождаемый относительным поиском, необходимо использовать функцию `FSMatchAliasBulk`.
`alias`	Дескриптор к записи псевдонима, которая будет разрешена и, при необходимости, обновил.
`target`	Указатель на `FSRef`. По успешному возврату, этому `FSRef` описывает цель записи псевдонима. Этот параметр должен указать на допустимое `FSRef` структура.
`wasChanged`	Указатель на указание булева значения, по возврату, записывает ли псевдоним в `alias` параметр был обновлен, потому что он содержал некоторую устаревшую информацию о цели. Если это обновляет запись псевдонима, `FSResolveAlias` наборы `wasChanged` параметр к `true`. Иначе, это устанавливает его в `false`. (`FSResolveAlias` никогда не обновляет минимальный псевдоним, таким образом, он никогда не устанавливает `wasChanged` к `true` при разрешении минимального псевдонима.

Возвращаемое значение

Код результата. Когда это находит указанный объем и родительский каталог, но не удается найти конечный файл или каталог в том расположении, FSResolveAlias возвраты fnfErr. Обратите внимание на то, что FSRef в alias параметр не допустим в этом случае.

Обсуждение

FSResolveAlias функция выполняет быстрый поиск цели псевдонима. Если разрешение успешно, FSResolveAlias возвраты (в target параметр) FSRef для системного объекта конечного файла, обновляет запись псевдонима при необходимости и отчеты (через wasChanged параметр), была ли обновлена запись. Если цель находится на размонтированном объеме AppleShare, FSResolveAlias автоматически монтирует объем. Если цель находится на размонтированном выбрасываемом объеме, FSResolveAlias просит пользователь вставлять объем. FSResolveAlias функционируйте выходы после того, как это найдет одну приемлемую цель.

После того, как это идентифицирует цель, FSResolveAlias сравнивает некоторую ключевую информацию о цели с информацией в записи псевдонима. Если информация отличается, FSResolveAlias обновляет запись для соответствия цели.

FSResolveAlias функционируйте выводит на экран стандартные диалоговые окна, когда это должно ввести от пользователя, такого как имя и пароль для монтирования удаленного объема. Пользователь может отменить разрешение через эти диалоговые окна.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    FSResolveAliasWithMountFlags
    FSResolveAliasWithMountFlags

(OS X v10.8)

Возвраты FSRef к цели псевдонима.

Оператор осуждения

Использовать CFURLCreateByResolvingBookmarkData вместо этого.

Объявление

Objective C

OSErr FSResolveAliasWithMountFlags ( const FSRef *fromFile, AliasHandle inAlias, FSRef *target, Boolean *wasChanged, unsigned long mountFlags );

Параметры

`fromFile`	Указатель на начальную точку для относительного поиска. Если Вы передаете `NULL` в этом параметре, `FSResolveAliasWithMountFlags` выполняет абсолютный поиск. Если Вы передаете указатель на допустимое `FSRef` в `fromFile` параметр, `FSResolveAliasWithMountFlags` выполняет относительный поиск цели, сопровождаемой абсолютным поиском, только если относительный поиск перестал работать. Если Вы хотите выполнить абсолютный поиск, сопровождаемый относительным поиском, необходимо использовать функцию `FSMatchAliasBulk`.
`inAlias`	Дескриптор к записи псевдонима, которая будет разрешена и, при необходимости, обновил.
`target`	Указатель на `FSRef` структура. По успешному возврату, этому `FSRef` относится к цели записи псевдонима. Этот параметр должен указать на допустимое `FSRef` структура.
`wasChanged`	Указатель на указание булева значения, по возврату, была ли запись псевдонима, которая будет разрешена, обновлена, потому что это содержало некоторую устаревшую информацию о цели. Если это обновляет запись псевдонима, `FSResolveAliasWithMountFlags` наборы `wasChanged` параметр к `true`. Иначе, это устанавливает его в `false`. (`FSResolveAliasWithMountFlags` никогда не обновляет минимальный псевдоним, таким образом, он никогда не устанавливает `wasChanged` к `true` при разрешении минимального псевдонима.
`mountFlags`	Управление опций, как разрешен псевдоним. Посмотрите, что Объем Монтирует Опции для описания значений, которые можно использовать здесь. Установите этот параметр на `kResolveAliasFileNoUI` предотвратить любое взаимодействие с пользователем, в то время как разрешается псевдоним.

Возвращаемое значение

Код результата.

Обсуждение

Функция FSResolveAliasWithMountFlags идентично FSResolveAlias за исключением того, что это обеспечивает mountFlags параметр, позволяя вызывающим сторонам дополнительное управление тем, как разрешен псевдоним.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.

Работа с файлами псевдонима средства поиска


    
    FSFollowFinderAlias
    FSFollowFinderAlias

(OS X v10.8)

Разрешает запись псевдонима, полученную из файла псевдонима Средства поиска.

Оператор осуждения

Сначала используйте CFURLCreateBookmarkDataFromFile, тогда используйте CFURLCreateByResolvingBookmarkData.

Объявление

Objective C

OSErr FSFollowFinderAlias ( FSRef *fromFile, AliasHandle alias, Boolean logon, FSRef *target, Boolean *wasChanged );

Параметры

`fromFile`	Указатель на файл для использования для первой попытки относительного разрешения; передайте указатель на файл псевдонима `FSRef` для этого параметра.
`alias`	Дескриптор к записи псевдонима, взятой от ресурсов файла псевдонима.
`logon`	Если `true`, менеджер по Псевдониму пытается смонтировать объем при необходимости для завершения разрешения псевдонима.
`target`	Указатель на `FSRef` структура. По возврату, этому `FSRef` относится к цели, найденной разрешением.
`wasChanged`	Указатель на булево значение. `FSFollowFinderAlias` наборы это значение к `true` если это обновило запись псевдонима.

Возвращаемое значение

Код результата.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    FSIsAliasFile
    FSIsAliasFile

(OS X v10.8)

Определяет, является ли объект файловой системы файлом псевдонима, файлом данных или папкой.

Оператор осуждения

Использовать CFURLCopyResourcePropertyForKey с kCFURLIsAliasFileKey вместо этого.

Объявление

Objective C

OSErr FSIsAliasFile ( const FSRef *fileRef, Boolean *aliasFileFlag, Boolean *folderFlag );

Параметры

`fileRef`	Указатель на файловую систему возражает для тестирования.
`aliasFileFlag`	Указатель на Логическую переменную. По возврату, значению `TRUE` указывает, что объект указал в `fileRef` параметр является файлом псевдонима. Значение `FALSE` указывает, что объект не является файлом псевдонима.
`folderFlag`	Указатель на Логическую переменную. По возврату, значению `TRUE` указывает, что объект указал в `fileRef` параметр является папкой. Значение `FALSE` указывает, что объект является файлом.

Возвращаемое значение

Код результата.

Обсуждение

Таблица 1 суммирует информацию, которую эта функция предоставляет об объекте, указанном в fileRef параметр:

**Таблица 1Information** об объекте файловой системы
Флаг Alias	Флаг Folder	Объектный вид
T	F	Файл псевдонима
F	F	Файл данных
F	T	Папка

Обратите внимание на то, что, если fileRef файл псевдонима, эта функция не предоставляет информации об объекте, к которому относится псевдоним. Чтобы узнать, является ли этот объект файлом или папкой, можно использовать FSResolveAliasFile.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    FSResolveAliasFile
    FSResolveAliasFile

(OS X v10.8)

Разрешает псевдоним, содержавшийся в файле псевдонима.

Оператор осуждения

Сначала используйте CFURLCreateBookmarkDataFromFile, тогда используйте CFURLCreateByResolvingBookmarkData.

Объявление

Objective C

OSErr FSResolveAliasFile ( FSRef *theRef, Boolean resolveAliasChains, Boolean *targetIsFolder, Boolean *wasAliased );

Параметры

`theRef`	Указатель на файл псевдонима Вы планируете открыться. Если функция завершается успешно, это `FSRef` описывает к файлу или каталогу, именуемому файлом псевдонима.
`resolveAliasChains`	Булево значение. Установите этот параметр на `TRUE` если Вы хотите `FSResolveAliasFile` разрешить все псевдонимы в цепочке (например, файл псевдонима, относящийся к файлу псевдонима и т.д.), останавливаясь только, когда это достигает конечного файла. Установите этот параметр на `FALSE` даже если цель является другим файлом псевдонима, если Вы хотите разрешить только один файл псевдонима.
`targetIsFolder`	Указатель на булево значение. `FSResolveAliasFile` функциональные возвраты `TRUE` в этом параметре, если `FSRef` в параметре `theRef` точки к каталогу или объему; иначе, `FSResolveAliasFile` возвраты `FALSE` в этом параметре.
`wasAliased`	Указатель на булево значение. `FSResolveAliasFile` функциональные возвраты `TRUE` в этом параметре, если `FSRef` в параметре `theRef` точки к псевдониму; иначе, `FSResolveAliasFile` возвраты `FALSE` в этом параметре.

Возвращаемое значение

Код результата. Когда это находит указанный объем и родительский каталог, но не удается найти конечный файл или каталог в том расположении, FSResolveAliasFile возвраты fnfErr.

Обсуждение

Если Ваше приложение обходит Средство поиска при управлении документами, это должно проверить на, и решение искажает себя при помощи FSResolveAliasFile функция.

FSResolveAliasFile функционируйте сначала проверяет файл каталога на файл или каталог, указанный в параметре theRef определить, является ли это псевдонимом и является ли это файлом или каталогом. Если объект не является псевдонимом, FSResolveAliasFile листы theRef неизменный, наборы targetIsFolder параметр к TRUE для каталога или объема и FALSE для файла, наборов wasAliased к FALSE, и возвраты noErr. Если объект является псевдонимом, FSResolveAliasFile решения это, помещает цель в параметр theRef, и наборы wasAliased флаг к TRUE.

Если FSResolveAliasFile получает код ошибки при разрешении псевдонима, это оставляет входные параметры, как они, и выходит, возвращая код ошибки. FSResolveAliasFile может возвратить любые ошибки Менеджера ресурсов или Файлового менеджера.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    FSResolveAliasFileWithMountFlags
    FSResolveAliasFileWithMountFlags

(OS X v10.8)

Разрешает псевдоним, содержавшийся в файле псевдонима.

Оператор осуждения

Сначала используйте CFURLCreateBookmarkDataFromFile, тогда используйте CFURLCreateByResolvingBookmarkData.

Объявление

Objective C

OSErr FSResolveAliasFileWithMountFlags ( FSRef *theRef, Boolean resolveAliasChains, Boolean *targetIsFolder, Boolean *wasAliased, unsigned long mountFlags );

Параметры

`theRef`	Указатель на файл псевдонима Вы планируете открыться. Если функция завершается успешно, это `FSRef` описывает файл или каталог, именуемый файлом псевдонима.
`resolveAliasChains`	Булево значение. Установите этот параметр на `TRUE` если Вы хотите `FSResolveAliasFileWithMountFlags` разрешить все псевдонимы в цепочке (например, файл псевдонима, относящийся к файлу псевдонима и т.д.), останавливаясь только, когда это достигает конечного файла. Установите этот параметр на `FALSE` даже если цель является другим файлом псевдонима, если Вы хотите разрешить только один файл псевдонима.
`targetIsFolder`	Указатель на булево значение. `FSResolveAliasFileWithMountFlags` функциональные возвраты `TRUE` в этом параметре, если `FSRef` в параметре `theRef` точки к каталогу или объему; иначе, `FSResolveAliasFileWithMountFlags` возвраты `FALSE` в этом параметре.
`wasAliased`	Указатель на булево значение. `FSResolveAliasFileWithMountFlags` функциональные возвраты `TRUE` в этом параметре, если `FSRef` в параметре `theRef` точки к псевдониму; иначе, `FSResolveAliasFileWithMountFlags` возвраты `FALSE` в этом параметре.
`mountFlags`	Управление опций, как разрешен файл псевдонима. Посмотрите, что Объем Монтирует Опции для описания значений, которые можно использовать здесь. Установите этот параметр на `kResolveAliasFileNoUI` в то время как псевдоним разрешается, для предотвращения любого взаимодействия с пользователем, включая диск переключают предупреждения.

Возвращаемое значение

Код результата.

Обсуждение

Функция FSResolveAliasFileWithMountFlags идентично FSResolveAliasFile за исключением того, что это обеспечивает mountFlags параметр, позволяя вызывающим сторонам дополнительное управление тем, как разрешен файл псевдонима.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.

Работа с Универсальными указателями процедуры для искажения обратных вызовов менеджера


    
    NewAliasFilterUPP
    NewAliasFilterUPP

(OS X v10.8)

Создает новый универсальный указатель процедуры (UPP) к псевдониму, фильтрующему функцию обратного вызова.

Объявление

Objective C

AliasFilterUPP NewAliasFilterUPP ( AliasFilterProcPtr userRoutine );

Параметры


      userRoutine

Указатель на Ваш псевдоним, фильтрующий функцию обратного вызова. Для получения дополнительной информации посмотрите FSAliasFilterProcPtr.

Возвращаемое значение

По возврату, UPP к псевдониму, фильтрующему функцию обратного вызова.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.

Не доступный 64-разрядным приложениям.

DisposeAliasFilterUPP DisposeAliasFilterUPP (OS X v10.8)

Избавляется от универсального указателя процедуры (UPP) к псевдониму, фильтрующему функцию обратного вызова.

Объявление

Objective C

void DisposeAliasFilterUPP ( AliasFilterUPP userUPP );

Параметры

userUPP

UPP для избавления.

Обсуждение

Посмотрите FSAliasFilterProcPtr для получения дополнительной информации о псевдониме, фильтрующем функции обратного вызова.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.8.
Не доступный 64-разрядным приложениям.
InvokeAliasFilterUPP InvokeAliasFilterUPP (OS X v10.8)

Вызывает Ваш псевдоним, фильтрующий функцию обратного вызова.

Объявление

Objective C

Boolean InvokeAliasFilterUPP ( CInfoPBPtr cpbPtr, Boolean *quitFlag, Ptr myDataPtr, AliasFilterUPP userUPP );

Обсуждение

Вы не должны должны быть использовать функцию InvokeAliasFilterUPP, как системные вызовы Ваш обратный вызов фильтрации псевдонима для Вас.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.8.
Не доступный 64-разрядным приложениям.

устаревшие (deprecated) функции

Исказите функции менеджера, использующие FSSpec тип данных был осужден. Вместо этого необходимо использовать эквивалент FSRef– основанные функции, включающие поддержку функций, таких как unicode и длинные имена файлов. Для получения дополнительной информации о FSSpec и FSRef типы, посмотрите Ссылку Файлового менеджера.


    
    NewAlias
    NewAlias

(OS X v10.4)

Создает полную запись псевдонима.

Оператор осуждения

Использовать FSNewAlias вместо этого.

Объявление

Objective C

OSErr NewAlias ( const FSSpec *fromFile, const FSSpec *target, AliasHandle *alias );

Параметры

`fromFile`	Указатель на начальную точку для относительного поиска. Если Вам не нужна относительная поисковая информация в записи псевдонима, передайте a `fromFile` значение `NULL`. Если Вы хотите `NewAlias` для записи относительной поисковой информации передайте указатель на допустимое `FSSpec` структура в этом параметре. Файлы или каталоги, указанные в `fromFile` и `target` параметры должны находиться на том же объеме.
`target`	Указатель на `FSSpec` структура для цели записи псевдонима.
`alias`	Указатель на дескриптор псевдонима. По возврату этот дескриптор относится к недавно создаваемой записи псевдонима. Если функции не удается создать запись псевдонима, она устанавливает `alias` к `NULL`.

Возвращаемое значение

Код результата.

Обсуждение

NewAlias функция создает запись псевдонима, описывающую указанную цель. Это выделяет хранение, заполняет запись и помещает рекордный дескриптор в то хранение в alias параметр. NewAlias всегда записывает имя и файл или каталог ID цели, ее даты создания, имени родительского каталога и ID, и имени тома и даты создания. Это также записывает полный путь цели и набор другой информации, относящейся к определению местоположения цели, проверке цели и монтированию объема цели, при необходимости. Вы можете иметь NewAlias храните относительную поисковую информацию также путем предоставления начальной точки для относительного поиска.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    NewAliasMinimal
    NewAliasMinimal

(OS X v10.4)

Создает короткую запись псевдонима быстро.

Оператор осуждения

Использовать FSNewAliasMinimal вместо этого.

Объявление

Objective C

OSErr NewAliasMinimal ( const FSSpec *target, AliasHandle *alias );

Параметры

`target`	Указатель на цель записи псевдонима.
`alias`	Указатель на дескриптор псевдонима. По возврату этот дескриптор относится к недавно создаваемой записи псевдонима. Если функции не удается создать запись псевдонима, она устанавливает `alias` к `NULL`.

Возвращаемое значение

Код результата.

Обсуждение

NewAliasMinimal функция создает запись псевдонима, содержащую только минимальную информацию, необходимую для описания цели: целевое имя, родительский каталог ID, имя тома и дата создания и информация о монтировании объема. NewAliasMinimal функционируйте использует стандартную структуру данных записи псевдонима, но она заполняет только части записи.

ResolveAlias функционируйте никогда не обновляет минимальную запись псевдонима.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    NewAliasMinimalFromFullPath
    NewAliasMinimalFromFullPath

(OS X v10.4)

Создает запись псевдонима, содержащую только полный путь цели.

Оператор осуждения

Использовать FSNewAliasMinimal или FSNewAliasMinimalUnicode вместо этого.

Объявление

Objective C

OSErr NewAliasMinimalFromFullPath ( short fullPathLength, const void *fullPath, ConstStr32Param zoneName, ConstStr31Param serverName, AliasHandle *alias );

Параметры

`fullPathLength`	Число символов в полном пути цели.
`fullPath`	Указатель на буфер, содержащий полный путь цели. Полный путь запускается с имени объема, включает все имена каталогов по пути к цели и заканчивается целевым именем. (Для описания путей см. документацию для Файлового менеджера.)
`zoneName`	Имя зоны AppleTalk объема AppleShare, на котором находится цель. Установите этот параметр на пустую строку, если Вам не нужен он.
`serverName`	Имя сервера AppleTalk объема AppleShare, на котором находится цель. Установите этот параметр на пустую строку, если Вам не нужен он.
`alias`	Указатель на дескриптор псевдонима. По возврату этот дескриптор относится к недавно создаваемой записи псевдонима. Если функции не удается создать запись псевдонима, она устанавливает `alias` к `NULL`.

Возвращаемое значение

Код результата.

Обсуждение

NewAliasMinimalFromFullPath функция создает запись псевдонима, идентифицирующую цель полным путем. Можно вызвать NewAliasMinimalFromFullPath для создания псевдонима записывают для файла, не существующего, или это находится на размонтированном объеме.

NewAliasMinimalFromFullPath функционируйте использует стандартную структуру данных записи псевдонима, но она заполняет только информацию, предоставленную во входных параметрах. Можно поэтому использовать NewAliasMinimalFromFullPath создать записи псевдонима для целей на размонтированных объемах.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    UpdateAlias
    UpdateAlias

(OS X v10.4)

Обновляет запись псевдонима.

Оператор осуждения

Использовать FSUpdateAlias вместо этого.

Объявление

Objective C

OSErr UpdateAlias ( const FSSpec *fromFile, const FSSpec *target, AliasHandle alias, Boolean *wasChanged );

Параметры

`fromFile`	Указатель на начальную точку для относительного поиска. Если Вам не нужна относительная поисковая информация в записи, передайте a `fromFile` значение `NULL`. Если Вы хотите `UpdateAlias` для записи относительной поисковой информации передайте указатель на допустимое `FSSpec` структура в этом параметре.
`target`	Указатель на цель записи псевдонима.
`alias`	Дескриптор к псевдониму записывает, чтобы быть обновленным.
`wasChanged`	Указатель на булево значение, указывающее, является ли недавно созданная запись псевдонима точно тем же как старым. Если новая запись совпадает со старым, `UpdateAlias` наборы `wasChanged` параметр к `false`. Иначе, это устанавливает его в `true`. Проверьте этот параметр, чтобы определить, необходимо ли сохранить обновленную запись.

Возвращаемое значение

Код результата.

Обсуждение

UpdateAlias функция восстанавливает всю запись псевдонима и заполняет ее как NewAlias функция была бы.

UpdateAlias функция всегда создает полную запись псевдонима. Когда Вы используете UpdateAlias для обновления минимальной записи псевдонима Вы преобразовываете минимальную запись на полную запись.

Специальные замечания

Эти два файла или каталога, указанные в fromFile и target параметры, должен находиться на том же объеме.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    GetAliasInfo
    GetAliasInfo

(OS X v10.3)

Получает информацию от записи псевдонима, фактически не разрешая запись.

Оператор осуждения

Использовать FSCopyAliasInfo вместо этого.

Объявление

Objective C

OSErr GetAliasInfo ( AliasHandle alias, AliasInfoType itemIndex, Str63 theString );

Параметры

`alias`	Дескриптор к псевдониму записывает, чтобы быть считанным.
`index`	Вид информации, которая будет получена. Если значение `index` положительное целое число, `GetAliasInfo` получает родительский каталог, имеющий тот же иерархический уровень выше цели как индексный параметр (например, `index` значение 2 возвратов имя родительского каталога родительского каталога цели). Можно поэтому собрать имена цели и все ее родительские каталоги путем совершения повторенных звонков к `GetAliasInfo` с постепенно увеличивающимися индексными значениями, начиная со значения 0. Когда значение `index` больше, чем число уровней между целью и корнем, `GetAliasInfo` возвращает пустую строку. Можно также установить `index` параметр к одному из значений описан в Константах Типа информации.
`theString`	Строка, что, по возврату, содержит запрошенную информацию.

Возвращаемое значение

Код результата.

Обсуждение

GetAliasInfo функционируйте возвращает информацию, хранившую в записи псевдонима, которая не могла бы быть текущей. Чтобы гарантировать, что информация является текущей, можно разрешить и обновить запись псевдонима перед вызовом GetAliasInfo.

GetAliasInfo функция не может обеспечить все виды информации о минимальном псевдониме.

Специальные замечания

Используйте FSCopyAliasInfo функция вместо GetAliasInfo. GetAliasInfo надежно не возвращает информацию для псевдонимов к элементам в файловых системах POSIX. Кроме того, GetAliasInfo не поддерживает имена unicode или называет дольше, чем 32 байта. Если имя цели псевдонима более длинно, чем 32 байта, имя является усеченным, и идентификатор файла и расширение (если таковые имеются) добавляются, прежде чем имя возвращается GetAliasInfo.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.3.

Не доступный 64-разрядным приложениям.


    
    MatchAlias
    MatchAlias

(OS X v10.4)

Идентифицирует список возможных соответствий для псевдонима и передает список через дополнительный фильтр выбора. Фильтр может возвратить больше чем одно возможное соответствие.

Оператор осуждения

Использовать FSMatchAliasBulk вместо этого.

Объявление

Objective C

OSErr MatchAlias ( const FSSpec *fromFile, unsigned long rulesMask, AliasHandle alias, short *aliasCount, FSSpecArrayPtr aliasList, Boolean *needsUpdate, AliasFilterUPP aliasFilter, void *yourDataPtr );

Параметры

`fromFile`	Указатель на начальную точку для относительного поиска. Если Вы не хотите `MatchAlias` для выполнения относительного поиска установить `fromFile` к `NULL`. Если Вы хотите `MatchAlias` для выполнения относительного поиска передайте указатель на структуру спецификации файловой системы, описывающую начальную точку для поиска.
`rulesMask`	Ряд правил для руководства разрешения. Передайте сумму всех правил, которые Вы хотите вызвать. Для описания значений можно использовать в этом параметре, видеть Соответствие Констант.
`alias`	Дескриптор к псевдониму записывает, чтобы быть разрешенным.
`aliasCount`	На вводе, указателе на максимальное количество возможных соответствий для возврата. На выводе возвратилось фактическое число соответствий.
`aliasList`	Указатель на массив, содержащий результаты поиска, список возможных кандидатов.
`needsUpdate`	Указатель на булев флаг, указывающий, записывает ли псевдоним, чтобы быть разрешенным потребности, которые будут обновлены.
`aliasFilter`	Определенная с помощью приложения функция фильтра. Менеджер по Псевдониму выполняет эту функцию каждый раз, когда она идентифицирует возможное соответствие и после того, как поиск продолжался в течение трех секунд без соответствия. Ваша функция фильтра возвращает булево значение, определяющее, отбрасывается ли возможное соответствие (`true`) или добавил к списку возможных целей (`false`). Это может также завершить поиск путем установки переменного параметра `quitFlag`. Посмотрите `FSAliasFilterProcPtr` для описания функции фильтра.
`yourDataPtr`	Указатель на данные, которые будут переданы функции фильтра. `yourDataPtr` параметр может указать на любые данные, в которых Ваше приложение, возможно, нуждалось бы в функции фильтра.

Возвращаемое значение

Код результата.

Обсуждение

Если MatchAlias находит родительский каталог на корректном объеме, но не находит цель, это устанавливает aliasCount параметр к 1, помещает структуру спецификации файловой системы для цели в списке результатов и возвраты fnfErr. FSSpec структура допустима, несмотря на то, что не существует объект, который она описывает. Эта информация предназначается как «подсказка», позволяющая Вам исследовать возможные решения отказа разрешения. Можно, например, использовать FSSpec структура и функция Файлового менеджера FSpCreate создать замену для недостающего файла.

После того, как это идентифицирует цель, MatchAlias сравнивает некоторую ключевую информацию о цели с той же информацией в записи. Если информация не соответствует, MatchAlias наборы needsUpdate флаг к true. Ключевая информация

имя цели
каталог ID родителя цели
идентификатор файла или каталог ID цели
имя и дата создания объема, на котором находится цель

MatchAlias функционируйте также устанавливает needsUpdate флаг к true если это идентифицирует список возможных соответствий, а не единственного соответствия или если kARMsearchRelFirst установлен в rulesMask параметр, но цель идентифицируется или посредством абсолютного поиска или посредством исчерпывающего поиска. Иначе, MatchAlias функционируйте устанавливает needsUpdate флаг к false. MatchAlias всегда наборы needsUpdate флаг к false при разрешении псевдонима, создаваемого NewAliasMinimal. Если Вы хотите обновить запись псевдонима для отражения конечных результатов разрешения, вызвать UpdateAlias.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    MatchAliasNoUI
    MatchAliasNoUI

(OS X v10.5)

Идентифицирует список возможных соответствий для псевдонима без любого взаимодействия с пользователем.

Оператор осуждения

Использовать FSMatchAliasBulk с kARMNoUI флаг вместо этого.

Объявление

Objective C

OSErr MatchAliasNoUI ( const FSSpec *fromFile, unsigned long rulesMask, AliasHandle alias, short *aliasCount, FSSpecArrayPtr aliasList, Boolean *needsUpdate, AliasFilterUPP aliasFilter, void *yourDataPtr );

Параметры

`fromFile`	Указатель на начальную точку для относительного поиска. Если Вы не хотите `MatchAliasNoUI` для выполнения относительного поиска установить `fromFile` к `NULL`. Если Вы хотите `MatchAliasNoUI` для выполнения относительного поиска передайте указатель на структуру спецификации файловой системы, описывающую начальную точку для поиска.
`rulesMask`	Ряд правил для руководства разрешения. Передайте сумму всех правил, которые Вы хотите вызвать. Для описания значений можно использовать в этом параметре, видеть Соответствие Констант.
`alias`	Дескриптор к псевдониму записывает, чтобы быть разрешенным.
`aliasCount`	На вводе, указателе на максимальное количество возможных соответствий для возврата. На выводе возвратилось фактическое число соответствий.
`aliasList`	Указатель на массив `FSSpec` структуры, который содержит, по возврату, результатам поиска, списку возможных кандидатов.
`needsUpdate`	Указатель на булев флаг, по возврату, указывающий, должна ли быть обновлена запись псевдонима.
`aliasFilter`	Определенная с помощью приложения функция фильтра. Менеджер по Псевдониму выполняет эту функцию каждый раз, когда она идентифицирует возможное соответствие и после того, как поиск продолжался в течение трех секунд без соответствия. Ваша функция фильтра возвращает булево значение, определяющее, отбрасывается ли возможное соответствие (`true`) или добавил к списку возможных целей (`false`). Это может также завершить поиск путем установки переменного параметра `quitFlag`. Посмотрите `FSAliasFilterProcPtr` для описания функции фильтра.
`yourDataPtr`	Указатель на данные, которые будут переданы функции фильтра. `yourDataPtr` параметр может указать на любые данные, в которых Ваше приложение, возможно, нуждалось бы в функции фильтра.

Возвращаемое значение

Код результата.

Обсуждение

MatchAliasNoUI функция действует таким же образом в качестве MatchAlias функция; однако, это не представляет интерфейс пользователю. Посмотрите обсуждение MatchAlias для получения дополнительной информации.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.5.

Не доступный 64-разрядным приложениям.


    
    ResolveAlias
    ResolveAlias

(OS X v10.4)

Идентифицирует единственную наиболее вероятную цель записи псевдонима.

Оператор осуждения

Использовать FSResolveAlias вместо этого.

Объявление

Objective C

OSErr ResolveAlias ( const FSSpec *fromFile, AliasHandle alias, FSSpec *target, Boolean *wasChanged );

Параметры

`fromFile`	Указатель на начальную точку для относительного поиска. Если Вы передаете a `fromFile` параметр `NULL`, `ResolveAlias` выполняет только абсолютный поиск. Если Вы передаете указатель на допустимое `FSSpec` структура в `fromFile` параметр, `ResolveAlias` выполняет относительный поиск цели, сопровождаемой абсолютным поиском, только если относительный поиск перестал работать. Если Вы хотите выполнить абсолютный поиск, сопровождаемый относительным поиском, необходимо использовать `MatchAlias` функция.
`alias`	Дескриптор к записи псевдонима, которая будет разрешена и, при необходимости, обновил.
`target`	Указатель на цель записи псевдонима. Этот параметр должен быть допустимым `FSSpec` структура.
`wasChanged`	Указатель на булево значение, указывающее, была ли запись псевдонима, которая будет разрешена, обновлена, потому что это содержало некоторую устаревшую информацию о цели. Если это обновляет запись псевдонима, `ResolveAlias` наборы `wasChanged` параметр к `true`. Иначе, это устанавливает его в `false`. (`ResolveAlias` никогда не обновляет минимальный псевдоним, таким образом, он никогда не устанавливает `wasChanged` к `true` при разрешении минимального псевдонима.

Возвращаемое значение

Код результата.

Обсуждение

ResolveAlias функция выполняет быстрый поиск цели псевдонима. Если разрешение успешно, ResolveAlias возвраты (в target параметр) FSSpec структура для системного объекта конечного файла, обновляет запись псевдонима при необходимости и отчеты (через wasChanged параметр), была ли обновлена запись. Если цель находится на размонтированном объеме AppleShare, ResolveAlias автоматически монтирует объем. Если цель находится на размонтированном выбрасываемом объеме, ResolveAlias просит пользователь вставлять объем. ResolveAlias функционируйте выходы после того, как это найдет одну приемлемую цель.

После того, как это идентифицирует цель, ResolveAlias сравнивает некоторую ключевую информацию о цели с информацией в записи псевдонима. (Описание MatchAlias функционируйте перечисляет ключевую информацию.), Если информация отличается, ResolveAlias обновляет запись для соответствия цели.

Когда это находит указанный объем и родительский каталог, но не удается найти конечный файл или каталог в том расположении, ResolveAlias возвращает код результата fnfErr и заполняет target параметр с полным FSSpec структура, описывающая цель (т.е. ссылочный номер объема, родительский каталог ID, и имя файла или имя папки). FSSpec структура допустима, несмотря на то, что не существует объект, который она описывает. Эта информация предназначается как «подсказка», позволяющая Вам исследовать возможные решения отказа разрешения. Можно, например, передать FSSpec структура к функции Файлового менеджера FSpCreate создать замену для недостающего файла.

ResolveAlias функционируйте выводит на экран стандартные диалоговые окна, когда это должно ввести от пользователя, такого как имя и пароль для монтирования удаленного объема. Пользователь может отменить разрешение через эти диалоговые окна.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    ResolveAliasWithMountFlags
    ResolveAliasWithMountFlags

(OS X v10.4)

Идентифицирует цель псевдонима.

Оператор осуждения

Использовать FSResolveAliasWithMountFlags вместо этого.

Объявление

Objective C

OSErr ResolveAliasWithMountFlags ( const FSSpec *fromFile, AliasHandle alias, FSSpec *target, Boolean *wasChanged, unsigned long mountFlags );

Параметры

`fromFile`	Указатель на начальную точку для относительного поиска. Если Вы передаете `NULL` в этом параметре, `ResolveAliasWithMountFlags` выполняет только абсолютный поиск. Если Вы передаете указатель на допустимое `FSSpec` структура в `fromFile` параметр, `ResolveAliasWithMountFlags` выполняет относительный поиск цели, сопровождаемой абсолютным поиском, только если относительный поиск перестал работать. Если Вы хотите выполнить абсолютный поиск, сопровождаемый относительным поиском, необходимо использовать `MatchAlias` функция.
`alias`	Дескриптор к записи псевдонима, которая будет разрешена и, при необходимости, обновил.
`target`	Указатель на `FSSpec` структура. По возврату, этому `FSSpec` идентифицирует цель записи псевдонима. Этот параметр должен указать на допустимое `FSSpec` структура.
`wasChanged`	Указатель на указание булева значения, по возврату, была ли запись псевдонима, которая будет разрешена, обновлена, потому что это содержало некоторую устаревшую информацию о цели. Если это обновляет запись псевдонима, `ResolveAliasWithMountFlags` наборы `wasChanged` параметр к `true`. Иначе, это устанавливает его в `false`. (`ResolveAliasWithMountFlags` никогда не обновляет минимальный псевдоним, таким образом, он никогда не устанавливает `wasChanged` к `true` при разрешении минимального псевдонима.
`mountFlags`	Управление опций, как разрешен псевдоним. Посмотрите, что Объем Монтирует Опции для описания значений, которые можно использовать здесь. Установите этот параметр на `kResolveAliasFileNoUI` предотвратить любое взаимодействие с пользователем, в то время как разрешается псевдоним.

Возвращаемое значение

Код результата.

Обсуждение

Функция ResolveAliasWithMountFlags идентично ResolveAlias за исключением того, что это обеспечивает mountFlags параметр, позволяя вызывающим сторонам дополнительное управление тем, как разрешен псевдоним.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    FollowFinderAlias
    FollowFinderAlias

(OS X v10.5)

Разрешает запись псевдонима, полученную из файла псевдонима Средства поиска.

Оператор осуждения

Использовать FSFollowFinderAlias вместо этого.

Объявление

Objective C

OSErr FollowFinderAlias ( const FSSpec *fromFile, AliasHandle alias, Boolean logon, FSSpec *target, Boolean *wasChanged );

Параметры

`fromFile`	Указатель на спецификацию файловой системы, указывающую файл для первой попытки относительного разрешения; передайте указатель на файл псевдонима `FSSpec` для этого параметра.
`alias`	Дескриптор к записи псевдонима, взятой от ресурсов файла псевдонима.
`logon`	Если `true`, менеджер по Псевдониму пытается смонтировать объем при необходимости для завершения разрешения псевдонима.
`target`	Указатель на `FSSpec` структура. По возврату, этому `FSSpec` относится к цели, найденной разрешением.
`wasChanged`	Указатель на булево значение. `FollowFinderAlias` наборы это значение к `true` если это обновило запись псевдонима. Если псевдоним был обновлен, необходимо вызвать `ChangedResource` и `WriteResource` если обновленная запись должна быть сохранена в файле ресурсов.

Возвращаемое значение

Код результата.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.5.

Не доступный 64-разрядным приложениям.


    
    IsAliasFile
    IsAliasFile

(OS X v10.4)

Определяет, является ли объект файловой системы файлом псевдонима, файлом данных или папкой.

Оператор осуждения

Использовать FSIsAliasFile вместо этого.

Объявление

Objective C

OSErr IsAliasFile ( const FSSpec *fileFSSpec, Boolean *aliasFileFlag, Boolean *folderFlag );

Параметры

`fileFSSpec`	Указатель на структуру спецификации файла, описывающую файл.
`aliasFileFlag`	Указатель на Логическую переменную. По возврату, значению `TRUE` указывает, что объект указал в `fileRef` параметр является файлом псевдонима. Значение `FALSE` указывает, что объект не является файлом псевдонима.
`folderFlag`	Указатель на Логическую переменную. По возврату, значению `TRUE` указывает, что объект указал в `fileRef` параметр является папкой. Значение `FALSE` указывает, что объект является файлом.

Возвращаемое значение

Код результата.

Обсуждение

Эта функция определяет, является ли файл файлом псевдонима.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    ResolveAliasFile
    ResolveAliasFile

(OS X v10.4)

Разрешает псевдоним, содержавшийся в файле псевдонима.

Оператор осуждения

Использовать FSResolveAliasFile вместо этого.

Объявление

Objective C

OSErr ResolveAliasFile ( FSSpec *theSpec, Boolean resolveAliasChains, Boolean *targetIsFolder, Boolean *wasAliased );

Параметры

`theSpec`	Указатель на файл псевдонима Вы планируете открыться. Если функция завершается успешно, это `FSSpec` относится к файлу или каталогу, именовавшемуся файлом псевдонима.
`resolveAliasChains`	Булево значение. Установите этот параметр на `TRUE` если Вы хотите `ResolveAliasFile` разрешить все псевдонимы в цепочке (например, файл псевдонима, относящийся к файлу псевдонима и т.д.), останавливаясь только, когда это достигает конечного файла. Установите этот параметр на `FALSE` даже если цель является другим файлом псевдонима, если Вы хотите разрешить только один файл псевдонима.
`targetIsFolder`	Возвращаемый параметр только. `ResolveAliasFile` функциональные возвраты `TRUE` в этом параметре, если структура спецификации файла в параметре `theSpec` точки к каталогу или объему; иначе, `ResolveAliasFile` возвраты `FALSE` в этом параметре.
`wasAliased`	Возвращаемый параметр только. `ResolveAliasFile` функциональные возвраты `TRUE` в этом параметре, если структура спецификации файла в параметре `theSpec` точки к псевдониму; иначе, `ResolveAliasFile` возвраты `FALSE` в этом параметре.

Возвращаемое значение

Код результата.

Обсуждение

Если Ваше приложение обходит Средство поиска при управлении документами, это должно проверить на, и решение искажает себя при помощи ResolveAliasFile функция.

ResolveAliasFile функционируйте сначала проверяет файл каталога на файл или каталог, указанный в параметре theSpec определить, является ли это псевдонимом и является ли это файлом или каталогом. Если объект не является псевдонимом, ResolveAliasFile листы theSpec неизменный, наборы targetIsFolder параметр к TRUE для каталога или объема и FALSE для файла, наборов wasAliased к FALSE, и возвраты noErr. Если объект является псевдонимом, ResolveAliasFile решения это, помещает цель в параметр theSpec, и наборы wasAliased флаг к TRUE.

Когда ResolveAliasFile находит указанный объем и родительский каталог, но не удается найти конечный файл или каталог в том расположении, ResolveAliasFile возвращает код результата fnfErr и заполняет параметр theSpec с полной структурой спецификации файловой системы, описывающей цель (т.е. ее ссылочный номер объема, родительский каталог ID, и имя файла или имя папки). Структура спецификации файловой системы допустима, несмотря на то, что не существует объект, который она описывает. Эта информация предназначается как «подсказка», позволяющая Вам исследовать возможные решения отказа разрешения. Можно, например, использовать структуру спецификации файловой системы для создания замены для недостающего файла с функцией Файлового менеджера FSpCreate.

Если ResolveAliasFile получает код ошибки при разрешении псевдонима, это оставляет входные параметры, как они, и выходит, возвращая код ошибки. ResolveAliasFile может возвратить любые ошибки Менеджера ресурсов или Файлового менеджера.

Специальные замечания

Прежде, чем вызвать ResolveAliasFile функция, необходимо удостовериться, что это доступно при помощи Gestalt функция с gestaltAliasMgrAttr селектор.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    ResolveAliasFileWithMountFlags
    ResolveAliasFileWithMountFlags

(OS X v10.5)

Разрешает псевдоним, содержавшийся в файле псевдонима.

Оператор осуждения

Использовать FSResolveAliasFileWithMountFlags вместо этого.

Объявление

Objective C

OSErr ResolveAliasFileWithMountFlags ( FSSpec *theSpec, Boolean resolveAliasChains, Boolean *targetIsFolder, Boolean *wasAliased, unsigned long mountFlags );

Параметры

`theSpec`	Указатель на файл псевдонима Вы планируете открыться. Если функция завершается успешно, это `FSSpec` относится к файлу или каталогу, именовавшемуся файлом псевдонима.
`resolveAliasChains`	Булево значение. Установите этот параметр на `TRUE` если Вы хотите `ResolveAliasFileWithMountFlags` разрешить все псевдонимы в цепочке (например, файл псевдонима, относящийся к файлу псевдонима и т.д.), останавливаясь только, когда это достигает конечного файла. Установите этот параметр на `FALSE` даже если цель является другим файлом псевдонима, если Вы хотите разрешить только один файл псевдонима.
`targetIsFolder`	Возвращаемый параметр только. `ResolveAliasFileWithMountFlags` функциональные возвраты `TRUE` в этом параметре, если структура спецификации файла в параметре `theSpec` точки к каталогу или объему; иначе, `ResolveAliasFileWithMountFlags` возвраты `FALSE` в этом параметре.
`wasAliased`	Возвращаемый параметр только. `ResolveAliasFileWithMountFlags` функциональные возвраты `TRUE` в этом параметре, если структура спецификации файла в параметре `theSpec` точки к псевдониму; иначе, `ResolveAliasFileWithMountFlags` возвраты `FALSE` в этом параметре.
`mountFlags`	Управление опций, как разрешен файл псевдонима. Посмотрите, что Объем Монтирует Опции для описания значений, которые можно использовать здесь. Установите этот параметр на `kResolveAliasFileNoUI` предотвратить любое взаимодействие с пользователем, в то время как разрешается псевдоним.

Возвращаемое значение

Код результата.

Обсуждение

Функция ResolveAliasFileWithMountFlags идентично ResolveAliasFile за исключением того, что это обеспечивает mountFlags параметр.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.5.

Не доступный 64-разрядным приложениям.


    
    ResolveAliasFileWithMountFlagsNoUI
    ResolveAliasFileWithMountFlagsNoUI

(OS X v10.4)

Разрешает файл псевдонима без любого взаимодействия с пользователем.

Оператор осуждения

Использовать FSResolveAliasFileWithMountFlags с kResolveAliasFileNoUI флаг вместо этого.

Объявление

Objective C

OSErr ResolveAliasFileWithMountFlagsNoUI ( FSSpec *theSpec, Boolean resolveAliasChains, Boolean *targetIsFolder, Boolean *wasAliased, unsigned long mountFlags );

Параметры

`theSpec`	Указатель на файл псевдонима Вы планируете открыться. Если функция завершается успешно, это `FSSpec` относится к файлу или каталогу, именовавшемуся файлом псевдонима.
`resolveAliasChains`	Булево значение. Установите этот параметр на `TRUE` если Вы хотите `ResolveAliasFileWithMountFlagsNoUI` разрешить все псевдонимы в цепочке (например, файл псевдонима, относящийся к файлу псевдонима и т.д.), останавливаясь только, когда это достигает конечного файла. Установите этот параметр на `FALSE` даже если цель является другим файлом псевдонима, если Вы хотите разрешить только один файл псевдонима.
`targetIsFolder`	Возвращаемый параметр только. `ResolveAliasFileWithMountFlagsNoUI` функциональные возвраты `TRUE` в этом параметре, если структура спецификации файла в параметре `theSpec` точки к каталогу или объему; иначе, `ResolveAliasFileWithMountFlagsNoUI` возвраты `FALSE` в этом параметре.
`wasAliased`	Возвращаемый параметр только. `ResolveAliasFileWithMountFlagsNoUI` функциональные возвраты `TRUE` в этом параметре, если структура спецификации файла в параметре `theSpec` точки к псевдониму; иначе, `ResolveAliasFileWithMountFlagsNoUI` возвраты `FALSE` в этом параметре.
`mountFlags`	Управление опций, как разрешен файл псевдонима. Посмотрите, что Объем Монтирует Опции для описания значений, которые можно использовать здесь. Установите этот параметр на `kResolveAliasFileNoUI` в то время как псевдоним разрешается, для предотвращения любого взаимодействия с пользователем, включая диск переключают предупреждения.

Возвращаемое значение

Код результата.

Обсуждение

Функция ResolveAliasFileWithMountFlagsNoUI идентично ResolveAliasFile за исключением того, что это не представляет интерфейса пользователю.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.

Обратные вызовы

Исказите разные обратные вызовы менеджера


    
    AliasFilterProcPtr
    AliasFilterProcPtr

Определяет указатель на псевдоним, фильтрующий функцию обратного вызова, отфильтровывающую возможные цели, идентифицированные FSMatchAlias функция.

Объявление

Objective C

typedef Boolean (*AliasFilterProcPtr) ( CInfoPBPtr cpbPtr, Boolean * quitFlag, Ptr myDataPtr );

Параметры

`cpbPtr`	Указатель на блок параметра информации о каталоге. Когда Ваша функция вызвана, `cpbPtr` параметр указывает на блок параметра информации о каталоге возможного соответствия (возвращенный функцией Файлового менеджера `PBGetCatInfo`).
`quitFlag`	На выходе, набор это к `true` если Вы хотите завершить поиск.
`myDataPtr`	Указатель на любые специализированные данные, которые передало Ваше приложение, когда это вызвало `FSMatchAlias`. Этот параметр позволяет Вашей функции фильтра получать доступ к любым данным, которые Ваше приложение установило самостоятельно.

Возвращаемое значение

Ваша функция должна возвратиться true указать, что возможное соответствие должно быть отброшено, или false указать, что возможное соответствие должно быть добавлено к списку возможных целей.

Обсуждение

Можно записать собственную функцию фильтра для исследования возможных целей, идентифицированных FSMatchAlias функция. FSMatchAlias вызовы функции Ваш фильтр функционирует каждый раз, он идентифицирует возможное соответствие.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Не доступный 64-разрядным приложениям.


    
    FSAliasFilterProcPtr
    FSAliasFilterProcPtr

Определяет указатель на псевдоним, фильтрующий функцию обратного вызова, отфильтровывающую возможные цели, идентифицированные FSMatchAliasBulk функция.

Объявление

Swift

typealias FSAliasFilterProcPtr = CFunctionPointer<((UnsafePointer<FSRef>, UnsafeMutablePointer<Boolean>, Ptr) -> Boolean)>

Objective C

typedef Boolean (*FSAliasFilterProcPtr) ( FSRef *ref, Boolean *quitFlag, Ptr myDataPtr );

Параметры

`ref`	Указатель на объект файловой системы. Когда Ваша функция вызвана, `ref` параметр указывает на возможное соответствие.
`quitFlag`	На выводе, набор этот булев флаг к `true` если Вы хотите завершить поиск.
`myDataPtr`	Указатель на любые специализированные данные, которые передало Ваше приложение, когда это вызвало `FSMatchAliasBulk`. Этот параметр позволяет Вашей функции фильтра получать доступ к любым данным, которые Ваше приложение установило самостоятельно.

Возвращаемое значение

Обсуждение

Можно записать собственную функцию фильтра для исследования возможных целей, идентифицированных FSMatchAliasBulk функция. FSMatchAliasBulk вызовы функции Ваш фильтр функционирует каждый раз, он идентифицирует возможное соответствие.

Оператор импорта

Objective C

@import CoreServices;

Swift

import CoreServices

Доступность

Доступный в OS X v10.5 и позже.

Типы данных

AliasInfoType AliasInfoType

Определяет тип информации записи псевдонима, используемый в индексном параметре GetAliasInfo.

Объявление

Swift

typealias AliasInfoType = Int16

Objective C

typedef short AliasInfoType;

Оператор импорта

Objective C

@import CoreServices;

Swift

import CoreServices

Доступность

Доступный в OS X v10.0 и позже.
AliasFilterUPP AliasFilterUPP

Определяет универсальный указатель процедуры (UPP) к функции фильтрации псевдонима.

Объявление

Objective C

typedef AliasFilterProcPtr AliasFilterUPP;

Обсуждение

Посмотрите FSAliasFilterProcPtr для получения дополнительной информации о функциях фильтрации псевдонима.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.
Не доступный 64-разрядным приложениям.


      
      AliasRecord

Определяет запись псевдонима.

Объявление

Swift

struct AliasRecord { var hidden: (UInt8, UInt8, UInt8, UInt8, UInt8, UInt8) }

Objective C

struct AliasRecord { OSType userType; unsigned short aliasSize; }; typedef struct AliasRecord AliasRecord; typedef AliasRecord * AliasPtr; typedef AliasPtr * AliasHandle;

Поля


      userType

4-байтовое поле, которое может содержать специализированные данные. Когда запись псевдонима создается, это поле содержит 0. Ваше приложение может использовать это поле в своих собственных целях.


      aliasSize

Размер, в байтах, присвоился к записи псевдонима во время ее создания или обновления. Это - общий размер записи, включая userType и aliasSize поля, а также данные переменной длины, которые являются частными менеджеру по Псевдониму.

Обсуждение

Менеджер по Псевдониму использует записи псевдонима, чтобы хранить информацию, позволяющую ему определять местоположение объекта в файловой системе.

Доступность

Доступный в OS X v10.0 и позже.


      
      FSAliasInfo

Определяет блок информации, переданный FSCopyAliasInfo функция.

Объявление

Swift

struct FSAliasInfo { var volumeCreateDate: UTCDateTime var targetCreateDate: UTCDateTime var fileType: OSType var fileCreator: OSType var parentDirID: UInt32 var nodeID: UInt32 var filesystemID: UInt16 var signature: UInt16 var volumeIsBootVolume: Boolean var volumeIsAutomounted: Boolean var volumeIsEjectable: Boolean var volumeHasPersistentFileIDs: Boolean var isDirectory: Boolean }

Objective C

struct FSAliasInfo { UTCDateTime volumeCreateDate; UTCDateTime targetCreateDate; OSType fileType; OSType fileCreator; UInt32 parentDirID; UInt32 nodeID; UInt16 filesystemID; UInt16 signature; Boolean volumeIsBootVolume; Boolean volumeIsAutomounted; Boolean volumeIsEjectable; Boolean volumeHasPersistentFileIDs; Boolean isDirectory; }; typedef struct FSAliasInfo FSAliasInfo; typedef FSAliasInfo * FSAliasInfoPtr;

Поля

`volumeCreateDate`	Дата создания объема, на котором находится цель псевдонима.
`targetCreateDate`	Дата создания цели псевдонима.
`fileType`	Тип файла цели.
`fileCreator`	Код создателя цели.
`parentDirID`	Каталог ID родительского каталога цели.
`nodeID`	ID файла или каталога, который является целью псевдонима.
`filesystemID`	Файловая система ID.
`signature`	Подпись объема объема, на котором находится цель.
`volumeIsBootVolume`	Булево значение, указывающее, является ли объем загрузочным томом.
`volumeIsAutomounted`	Булево значение, указывающее, автосмонтирован ли объем.
`volumeIsEjectable`	Булево значение, указывающее, является ли объем выбрасываемым.
`volumeHasPersistentFileIDs`	Булево значение, указывающее, имеет ли объем персистентный идентификатор файла.
`isDirectory`	Булево значение, указывающее, является ли цель псевдонима каталогом.

Доступность

Доступный в OS X v10.2 и позже.

Константы

Маски информации о псевдониме
Возвращенный FSCopyAliasInfo функция для указания, какие поля информационной структуры псевдонима содержат допустимые данные.

Объявление

Swift

typealias FSAliasInfoBitmap = UInt32

Objective C

typedef UInt32 FSAliasInfoBitmap; enum { kFSAliasInfoNone = 0x00000000, kFSAliasInfoVolumeCreateDate = 0x00000001, kFSAliasInfoTargetCreateDate = 0x00000002, kFSAliasInfoFinderInfo = 0x00000004, kFSAliasInfoIsDirectory = 0x00000008, kFSAliasInfoIDs = 0x00000010, kFSAliasInfoFSInfo = 0x00000020, kFSAliasInfoVolumeFlags = 0x00000040 };

Константы
- kFSAliasInfoNone
  
  kFSAliasInfoNone
  
  Ни одна из информации о псевдониме не допустима.
  
  Доступный в OS X v10.2 и позже.
- kFSAliasInfoVolumeCreateDate
  
  kFSAliasInfoVolumeCreateDate
  
  Дата создания объема в volumeCreateDate поле допустимо.
  
  Доступный в OS X v10.2 и позже.
- kFSAliasInfoTargetCreateDate
  
  kFSAliasInfoTargetCreateDate
  
  Дата создания цели псевдонима, в targetCreateDate поле, допустимо.
  
  Доступный в OS X v10.2 и позже.
- kFSAliasInfoFinderInfo
  
  kFSAliasInfoFinderInfo
  
  Тип файла и информация о создателе, в fileType и fileCreator поля, допустимо.
  
  Доступный в OS X v10.2 и позже.
- kFSAliasInfoIsDirectory
  
  kFSAliasInfoIsDirectory
  
  Информация в isDirectory поле допустимо.
  
  Доступный в OS X v10.2 и позже.
- kFSAliasInfoIDs
  
  kFSAliasInfoIDs
  
  Родительский каталог ID и псевдоним предназначается для ID, в parentDirID и nodeID поля, допустимы.
  
  Доступный в OS X v10.2 и позже.
- kFSAliasInfoFSInfo
  
  kFSAliasInfoFSInfo
  
  Файловая система ID и подпись, в filesystemID и signature поля, допустимы.
  
  Доступный в OS X v10.2 и позже.
- kFSAliasInfoVolumeFlags
  
  kFSAliasInfoVolumeFlags
  
  Информация об объеме, в volumeIsBootVolume, volumeIsAutomounted, volumeIsEjectable, и volumeHasPersistentFileIDs поля, допустимо.
  
  Доступный в OS X v10.2 и позже.
Оператор импорта

Objective C

@import CoreServices;

Swift

import CoreServices

Доступность

Доступный в OS X v10.2 и позже.
Объем монтирует опции
Укажите, как должен быть разрешен псевдоним.

Объявление

Swift

var kResolveAliasFileNoUI: Int { get } var kResolveAliasTryFileIDFirst: Int { get }

Objective C

enum { kResolveAliasFileNoUI = 0x00000001, kResolveAliasTryFileIDFirst = 0x00000002 };

Константы
- kResolveAliasFileNoUI
  
  kResolveAliasFileNoUI
  
  Менеджер по Псевдониму должен разрешить псевдоним, не представляя пользовательский интерфейс.
  
  Доступный в OS X v10.0 и позже.
- kResolveAliasTryFileIDFirst
  
  kResolveAliasTryFileIDFirst
  
  Менеджер по Псевдониму должен искать цель псевдонима, использующую идентификаторы файла прежде, чем искать использование пути.
  
  Доступный в OS X v10.2 и позже.
Обсуждение

FSResolveAliasWithMountFlags, FSResolveAliasFileWithMountFlags, ResolveAliasWithMountFlags, ResolveAliasFileWithMountFlags, и ResolveAliasFileWithMountFlagsNoUI функции принимают эти константы mountFlags параметр, позволяя Вам указать, как должен быть разрешен псевдоним.
Соответствие констант
Укажите соответствующие критерии функций соответствия псевдонима.

Объявление

Swift

var kARMMountVol: Int { get } var kARMNoUI: Int { get } var kARMMultVols: Int { get } var kARMSearch: Int { get } var kARMSearchMore: Int { get } var kARMSearchRelFirst: Int { get } var kARMTryFileIDFirst: Int { get }

Objective C

enum { kARMMountVol = 0x00000001, kARMNoUI = 0x00000002, kARMMultVols = 0x00000008, kARMSearch = 0x00000100, kARMSearchMore = 0x00000200, kARMSearchRelFirst = 0x00000400, kARMTryFileIDFirst = 0x00000800 };

Константы
- kARMMountVol
  
  kARMMountVol
  
  Автоматически попытайтесь смонтировать объем цели, если он не смонтирован.
  
  Доступный в OS X v10.0 и позже.
- kARMNoUI
  
  kARMNoUI
  
  Остановитесь, если поиск требует взаимодействия с пользователем, такого как диалоговое окно пароля при монтировании удаленного объема. Если взаимодействие с пользователем необходимо и kARMNoUI имеет силу, поисковые сбои.
  
  Доступный в OS X v10.0 и позже.
- kARMMultVols
  
  kARMMultVols
  
  Ищите все смонтированные объемы. Поиск начинается с объема, на котором находилась цель, когда создавалась запись. Когда Вы указываете быстрый поиск всех смонтированных объемов, MatchAlias выполняет формальный быстрый поиск только на объеме, описанном в записи псевдонима. На всех других объемах это ищет цель ID или по имени в каталоге с указанным родительским каталогом ID. Когда Вы указываете исчерпывающий поиск многократных объемов, MatchAlias выполняет тот же поиск на всех объемах. При разрешении записи псевдонима, создаваемой NewAliasMinimalFromFullPath, MatchAlias игнорирует этот флаг.
  
  Доступный в OS X v10.0 и позже.
- kARMSearch
  
  kARMSearch
  
  Выполните быстрый поиск цели псевдонима. Если kARMSearchRelFirst не установлен, выполните абсолютный поиск сначала, сопровождаемый относительным поиском только если значение fromFile параметр не NULL и список соответствий не полон.
  
  Доступный в OS X v10.0 и позже.
- kARMSearchMore
  
  kARMSearchMore
  
  Выполните исчерпывающий поиск цели псевдонима. На объемах HFS исчерпывающий поиск использует функцию Файлового менеджера PBCatSearch для идентификации кандидатов с соответствием даты создания введите, и создатель. PBCatSearch функция доступна только на объемах HFS и только на системной рабочей версии 7.0 или позже. На не поддерживающих объемах MFS или объемах HFS PBCatSearch, исчерпывающий поиск делает серию индексируемых вызовов к функциям Файлового менеджера, с помощью тех же критериев поиска. Если Вы устанавливаете kARMSearchMore и или или оба из kARMSearch и kARMSearchRelFirst, MatchAlias выполняет быстрый поиск сначала.
  
  Доступный в OS X v10.0 и позже.
- kARMSearchRelFirst
  
  kARMSearchRelFirst
  
  Если kARMSearch также установлен, выполните относительный поиск перед абсолютным поиском. (Если kARMSearch также установлен и цель найдена посредством абсолютного поиска, MatchAlias наборы needsUpdate флаг к true.), Если ни один kARMSearch ни kARMSearchMore установлен, выполните только относительный поиск. Если kARMSearch не установлен, но kARMSearchMore установлен, выполните относительный поиск, сопровождаемый исчерпывающим поиском.
  
  Доступный в OS X v10.0 и позже.
- kARMTryFileIDFirst
  
  kARMTryFileIDFirst
  
  Выполните поиск с помощью идентификатора файла цели прежде, чем искать использование пути.
  
  Доступный в OS X v10.2 и позже.
Обсуждение

FSMatchAlias, FSMatchAliasNoUI, MatchAliasNoUI и MatchAlias функции используют эти константы для указания соответствующих критериев путем передачи суммы этих констант в rulesMask параметр. Необходимо указать по крайней мере один из последних трех параметров: kARMSearch, kARMSearchMore, и kARMSearchRelFirst.
Исказите тип ресурса

Указывает тип файла файла ресурсов псевдонима.

Объявление

Objective C

enum { rAliasType = 'alis' };
Константы типа информации
GetAliasInfo функционируйте использует эти константы в index параметр.

Объявление

Swift

var asiZoneName: Int { get } var asiServerName: Int { get } var asiVolumeName: Int { get } var asiAliasName: Int { get } var asiParentName: Int { get }

Objective C

enum { asiZoneName = -3, asiServerName = -2, asiVolumeName = -1, asiAliasName = 0, asiParentName = 1 };

Константы
- asiZoneName
  
  asiZoneName
  
  Если запись представляет цель на объеме AppleShare, получите имя зоны сервера. Иначе, возвратите пустую строку.
  
  Доступный в OS X v10.0 и позже.
- asiServerName
  
  asiServerName
  
  Если запись представляет цель на объеме AppleShare, получите имя сервера. Иначе, возвратите пустую строку.
  
  Доступный в OS X v10.0 и позже.
- asiVolumeName
  
  asiVolumeName
  
  Возвратите имя объема, на котором находится цель.
  
  Доступный в OS X v10.0 и позже.
- asiAliasName
  
  asiAliasName
  
  Возвратите имя цели.
  
  Доступный в OS X v10.0 и позже.
- asiParentName
  
  asiParentName
  
  Возвратите имя родительского каталога цели записи. Если цель является объемом, возвратите имя тома.
  
  Доступный в OS X v10.0 и позже.

Константы гештальта

Можно проверить на версию и информацию о доступности функции при помощи менеджера по Псевдониму селекторы, определенные в менеджере по Гештальту. Для получения дополнительной информации посмотрите менеджера по Гештальту Референса.