Spec-Zone .ru
спецификации, руководства, описания, API

Библиотека разработчика Mac

Разработчик

Ссылка платформы CoreServices запускает ссылку служб

Опции
Развертывание Target:

На этой странице
Язык:

Ссылка служб запуска

OS X Launch Services является API, позволяющий запущенному приложению открыть другие приложения или их файлы документов в пути, подобном Средству поиска или Прикреплению. Using Launch Services, приложение может выполнить такие задачи как:

  • Открытый (запускаются или активируются), другое приложение

  • Откройте документ или URL (унифицированный указатель ресурсов) в другом приложении

  • Идентифицируйте предпочтительное приложение для открытия данного документа или URL

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

  • Получите надлежащую информацию для отображения файла или URL на экране, таком как его значок, выведите на экран имя и добрую строку

  • Поддержите и обновите содержание меню Recent Items

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

Многие возможности Launch Services были раньше предоставлены средой рабочего стола. С появлением комплектов приложений Mac, однако, среда рабочего стола потеряла свою полноценность, так как это не обосновано о связанных приложениях и просто игнорирует их. Точно так же средства Launch Services для контакта с URLs были раньше реализованы через интернет-Конфигурацию API. Launch Services заменяет и заменяет среду рабочего стола и интернет-Конфигурацию с новым API, обеспечивающим схожую функциональность, но разработанный для работы должным образом в среде OS X.

Launch Services создавалась в частности для предотвращения общей потребности в приложениях, чтобы попросить, чтобы Средство поиска открыло приложение, документ или URL для них. В прошлом открытие таких элементов в пути, подобном Средству поиска, потребовало знания нескольких APIs, включая среду рабочего стола, Файловый менеджер, менеджера по Переводу, интернет-Конфигурацию, Диспетчер процессов и менеджера по корпоративным мероприятиям Apple. Средство поиска также имело неявное знание настольной базы данных и другой информации, не доступной в другом месте для определения соответствующего приложения, с которым можно открыть данный документ.

Launch Services удаляет эти специализированные знания из Средства поиска и изолирует его в единственном, прямом API, доступном любому приложению. Само Средство поиска OS X использует Launch Services для открытых приложений, документов и URLs в запросе пользователя. Так как Средство поиска не делает никакой дополнительной обработки вне вызова Launch Services, любого клиентского использования, Launch Services в этих целях, как гарантируют, будет вести себя тождественно к самому Средству поиска.

Прежде, чем считать этот документ, необходимо быть знакомы со связанным документом, Руководством по программированию Launch Services, представляющим концептуальный обзор Launch Services и ее операций.

Функции

Определение местоположения приложения

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

  • LSCopyDefaultApplicationURLForURL (_: _: _:) LSCopyDefaultApplicationURLForURL

    Возвращается приложение раньше открывало элемент.

    Объявление

    Swift

    func LSCopyDefaultApplicationURLForURL(_ inURL: CFURL!, _ inRoleMask: LSRolesMask, _ outError: UnsafeMutablePointer<Unmanaged<CFError>?>) -> Unmanaged<CFURL>!

    Objective C

    CFURLRef LSCopyDefaultApplicationURLForURL ( CFURLRef inURL, LSRolesMask inRoleMask, CFErrorRef *outError );

    Параметры

    inURL

    URL элемента, на который требуют приложение.

    inRoleMask

    Возвратить ли редактора или средство просмотра для inURL. Если Вы не заботитесь, который, использовать kLSRolesAll.

    outError

    При отказе, наборе к a CFErrorRef описание проблемы. Если Вы не интересуетесь этой информацией, передачей NULL. Вызывающая сторона ответственна за выпуск этого объекта.

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

    Если приемлемое приложение найдено, его URL возвращается. Если URL является a file:// URL, приложение, связанное с типом указанного файла или каталога, возвращается. Если схема URL's - что-то еще, ее обработчик схемы по умолчанию возвращается. Если никакое приложение не могло бы быть найдено, NULL возвращается и outError (если нет NULL) заполняется с kLSApplicationNotFoundErr.

    Вызывающая сторона ответственна за выпуск этого URL.

    Обсуждение

    Консультируется с обязательными таблицами для возврата приложения, которое использовалось бы для открытия inURL, если бы по этому дважды щелкнули в Средстве поиска. Это приложение будет указанным пользователями переопределением если надлежащий или значение по умолчанию иначе.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • LSGetApplicationForItem (_: _: _: _:) LSGetApplicationForItem (OS X v10.10)

    Определяет местоположение предпочтительного приложения для открытия элемента, определяемого ссылкой файловой системы.

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

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

    Объявление

    Swift

    func LSGetApplicationForItem(_ inItemRef: UnsafePointer<FSRef>, _ inRolesMask: LSRolesMask, _ outAppRef: UnsafeMutablePointer<FSRef>, _ outAppURL: UnsafeMutablePointer<Unmanaged<CFURL>?>) -> OSStatus

    Objective C

    OSStatus LSGetApplicationForItem ( const FSRef *inItemRef, LSRolesMask inRoleMask, FSRef *outAppRef, CFURLRef *outAppURL );

    Параметры

    inItemRef

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

    inRolesMask

    Немного маски, указывающей желаемую роль приложения или роли относительно определяемого элемента; посмотрите Ролевую Маску для описания этой маски. Если роль неважна, передача kLSRolesAll.

    outAppRef

    Указатель на ссылку файловой системы, что, по возврату, идентифицирует предпочтительное приложение элемента; посмотрите Ссылку Файлового менеджера в Документации управления файлами Углерода для описания FSRef тип данных. Передача NULL если Вы не интересуетесь идентификацией предпочтительного приложения в этой форме; однако, этот параметр и outAppURL не может оба быть NULL.

    outAppURL

    Указатель на Базовую Основу ссылка URL, что, по возврату, идентифицирует предпочтительное приложение элемента; посмотрите Ссылку CFURL в Базовой Справочной документации Основы для описания CFURLRef тип данных. Передача NULL если Вы не интересуетесь идентификацией предпочтительного приложения в этой форме; однако, этот параметр и outAppRef не может оба быть NULL.

    Несмотря на отсутствие слова Copy на ее имя эта функция сохраняет ссылочный объект URL от Вашего имени; Вы ответственны за выпуск этого объекта.

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

    Код результата; посмотрите Коды Результата Launch Services. Если никакое приложение, подходящее для открытия элемента, не будет найдено в базе данных Launch Services, то функция возвратит код результата kLSApplicationNotFoundErr.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

  • LSGetApplicationForURL (_: _: _: _:) LSGetApplicationForURL (OS X v10.10)

    Определяет местоположение предпочтительного приложения для открытия элемента, определяемого URL.

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

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

    Объявление

    Swift

    func LSGetApplicationForURL(_ inURL: CFURL!, _ inRolesMask: LSRolesMask, _ outAppRef: UnsafeMutablePointer<FSRef>, _ outAppURL: UnsafeMutablePointer<Unmanaged<CFURL>?>) -> OSStatus

    Objective C

    OSStatus LSGetApplicationForURL ( CFURLRef inURL, LSRolesMask inRoleMask, FSRef *outAppRef, CFURLRef *outAppURL );

    Параметры

    inURL

    Базовое ссылочное обозначение URL Основы элемента, предпочтительное приложение которого требуют; посмотрите Ссылку CFURL в Базовой Справочной документации Основы для описания CFURLRef тип данных.

    inRolesMask

    Немного маски, указывающей желаемую роль приложения или роли относительно определяемого элемента; посмотрите Ролевую Маску для описания этой маски. Этот параметр применяется только к URLs с компонентом схемы file, и проигнорирован для всех других схем. Если роль неважна, передача kLSRolesAll.

    outAppRef

    Указатель на ссылку файловой системы, что, по возврату, идентифицирует предпочтительное приложение элемента; посмотрите Ссылку Файлового менеджера в Документации управления файлами Углерода для описания FSRef тип данных. Передача NULL если Вы не интересуетесь идентификацией предпочтительного приложения в этой форме; однако, этот параметр и outAppURL не может оба быть NULL.

    outAppURL

    Указатель на Базовую Основу ссылка URL, что, по возврату, идентифицирует предпочтительное приложение элемента; посмотрите Ссылку CFURL в Базовой Справочной документации Основы для описания CFURLRef тип данных. Передача NULL если Вы не интересуетесь идентификацией предпочтительного приложения в этой форме; однако, этот параметр и outAppRef не может оба быть NULL.

    Несмотря на отсутствие слова Copy на ее имя эта функция сохраняет ссылочный объект URL от Вашего имени; Вы ответственны за выпуск этого объекта.

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

    Код результата; посмотрите Коды Результата Launch Services. Если никакое приложение, подходящее для открытия элемента, не будет найдено в базе данных Launch Services, то функция возвратит код результата kLSApplicationNotFoundErr.

    Обсуждение

    Если схема URL’s элемента file (определяющий или файл или каталог), выбор предпочтительного приложения основывается на расширении файла определяемого элемента, типе файла и подписи создателя, вместе с ролью, указанной inRolesMask параметр; иначе, это основывается на схеме URL (такой как http, ftp, или mailto).

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

  • LSCopyDefaultApplicationURLForContentType (_: _: _:) LSCopyDefaultApplicationURLForContentType

    Возвращается приложение раньше открывало тип контента (UTI).

    Объявление

    Swift

    func LSCopyDefaultApplicationURLForContentType(_ inContentType: CFString!, _ inRoleMask: LSRolesMask, _ outError: UnsafeMutablePointer<Unmanaged<CFError>?>) -> Unmanaged<CFURL>!

    Objective C

    CFURLRef LSCopyDefaultApplicationURLForContentType ( CFStringRef inContentType, LSRolesMask inRoleMask, CFErrorRef *outError );

    Параметры

    inContentType

    Uniform Type Identifier (UTI) элемента, на который требуют приложение.

    inRoleMask

    Возвратить ли редактора или средство просмотра для inContentType. Если Вы не заботитесь, который, использовать kLSRolesAll.

    outError

    При отказе, наборе к a CFErrorRef описание проблемы. Если Вы не интересуетесь этой информацией, передачей NULL. Вызывающая сторона ответственна за выпуск этого объекта.

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

    Если приемлемое приложение найдено, его URL возвращается. Если никакое приложение не могло бы быть найдено, NULL возвращается и outError (если нет NULL) заполняется с kLSApplicationNotFoundErr. Вызывающая сторона ответственна за выпуск этого URL.

    Обсуждение

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

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • LSGetApplicationForInfo (_: _: _: _: _: _:) LSGetApplicationForInfo (OS X v10.10)

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

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

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

    Объявление

    Swift

    func LSGetApplicationForInfo(_ inType: OSType, _ inCreator: OSType, _ inExtension: CFString!, _ inRolesMask: LSRolesMask, _ outAppRef: UnsafeMutablePointer<FSRef>, _ outAppURL: UnsafeMutablePointer<Unmanaged<CFURL>?>) -> OSStatus

    Objective C

    OSStatus LSGetApplicationForInfo ( OSType inType, OSType inCreator, CFStringRef inExtension, LSRolesMask inRoleMask, FSRef *outAppRef, CFURLRef *outAppURL );

    Параметры

    inType

    Тип файла для рассмотрения. Сравнение типов файлов чувствительно к регистру. Передача kLSUnknownType если тип файла элементов неважен.

    inCreator

    Подпись создателя для рассмотрения. Сравнение подписей создателя чувствительно к регистру. Передача kLSUnknownCreator если подпись создателя элементов неважна.

    inExtension

    Базовая Основа представляет в виде строки объект, указывающий расширение файла для рассмотрения; посмотрите Ссылку CFString в Базовой Справочной документации Основы для описания CFStringRef тип данных. Сравнение расширений файла нечувствительно к регистру. Передача NULL если расширение файла элементов неважно.

    inRolesMask

    Немного маски, указывающей желаемую роль приложения или роли относительно элементов с заданными характеристиками; посмотрите Ролевую Маску для описания этой маски. Если роль неважна, передача kLSRolesAll.

    outAppRef

    Указатель на ссылку файловой системы, что, по возврату, идентифицирует предпочтительное приложение для вводных элементов с заданными характеристиками; посмотрите Ссылку Файлового менеджера в Документации управления файлами Углерода для описания FSRef тип данных. Передача NULL если Вы не интересуетесь идентификацией предпочтительного приложения в этой форме; однако, этот параметр и outAppURL не может оба быть NULL.

    outAppURL

    Указатель на Базовую Основу ссылка URL, что, по возврату, идентифицирует предпочтительное приложение для элементов с заданными характеристиками; посмотрите Ссылку CFURL в Базовой Справочной документации Основы для описания CFURLRef тип данных. Передача NULL если Вы не интересуетесь идентификацией предпочтительного приложения в этой форме; однако, этот параметр и outAppRef не может оба быть NULL.

    Несмотря на отсутствие слова Copy на ее имя эта функция сохраняет ссылочный объект URL от Вашего имени; Вы ответственны за выпуск этого объекта.

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

    Код результата; посмотрите Коды Результата Launch Services. Если никакое приложение, подходящее для вводных элементов с заданными характеристиками, не будет найдено в базе данных Launch Services, то функция возвратит код результата kLSApplicationNotFoundErr.

    Обсуждение

    Можно запросить любую комбинацию один, два, или все три из характеристик, указанных inType, inCreator, и inExtension параметры; по крайней мере одна из этих характеристик должна быть предоставлена. Обратите внимание на то, что, так как выбор предпочтительного приложения подвергается любому документу обязательные предпочтения, которые, возможно, установил пользователь, выбранное приложение не обязательно будет приложением по умолчанию, которое соответствует входные характеристики, но может вместо этого быть указанным пользователями приложением, переопределяющим значение по умолчанию.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

  • LSCopyApplicationForMIMEType (_: _: _:) LSCopyApplicationForMIMEType (OS X v10.10)

    Определяет местоположение предпочтительного приложения для вводных элементов с указанным типом MIME.

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

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

    Объявление

    Swift

    func LSCopyApplicationForMIMEType(_ inMIMEType: CFString!, _ inRolesMask: LSRolesMask, _ outAppURL: UnsafeMutablePointer<Unmanaged<CFURL>?>) -> OSStatus

    Objective C

    OSStatus LSCopyApplicationForMIMEType ( CFStringRef inMIMEType, LSRolesMask inRoleMask, CFURLRef *outAppURL );

    Параметры

    inMIMEType

    Базовая Основа представляет в виде строки объект, указывающий тип MIME для рассмотрения; посмотрите Ссылку CFString в Базовой Справочной документации Основы для описания CFStringRef тип данных. Сравнение типов MIME нечувствительно к регистру.

    inRolesMask

    Немного маски, указывающей желаемую роль приложения или роли относительно элементов с указанным типом MIME; посмотрите Ролевую Маску для описания этой маски. Если роль неважна, передача kLSRolesAll.

    outAppURL

    Указатель на Базовую Основу ссылка URL, что, по возврату, идентифицирует предпочтительное приложение для элементов с указанным типом MIME; посмотрите Ссылку CFURL в Базовой Справочной документации Основы для описания CFURLRef тип данных. Вы ответственны за выпуск ссылочного объекта URL.

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

    Код результата; посмотрите Коды Результата Launch Services. Если никакое приложение, подходящее для вводных элементов с указанным типом MIME, не будет найдено в базе данных Launch Services, то функция возвратит код результата kLSApplicationNotFoundErr.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

  • LSCopyApplicationURLsForURL (_: _:) LSCopyApplicationURLsForURL

    Определяет местоположение всех известных приложений, подходящих для открытия элемента, определяемого URL.

    Объявление

    Swift

    func LSCopyApplicationURLsForURL(_ inURL: CFURL!, _ inRolesMask: LSRolesMask) -> Unmanaged<CFArray>!

    Objective C

    CFArrayRef LSCopyApplicationURLsForURL ( CFURLRef inURL, LSRolesMask inRoleMask );

    Параметры

    inURL

    Базовое ссылочное обозначение URL Основы элемента, на который требуют все подходящие приложения; посмотрите Ссылку CFURL в Базовой Справочной документации Основы для описания CFURLRef тип данных.

    inRolesMask

    Немного маски, указывающей желаемую роль приложений или роли относительно определяемого элемента; посмотрите Ролевую Маску для описания этой маски. Этот параметр применяется только к URLs с компонентом схемы file, и проигнорирован для всех других схем. Если роль неважна, передача kLSRolesAll.

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

    Массив Базовой Основы ссылки URL, один для каждого приложения, которое может открыть определяемый элемент с по крайней мере одной из указанных ролей. Вы ответственны за выпуск объекта массива. Если никакие подходящие приложения не будут найдены в базе данных Launch Services, то функция возвратится NULL

    Обсуждение

    Если схема URL’s элемента file (определяющий или файл или каталог), выбор подходящих приложений основывается на расширении файла определяемого элемента, типе файла и подписи создателя, вместе с ролью, указанной inRolesMask параметр; иначе, это основывается на схеме URL (такой как http, ftp, или mailto).

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • LSCanURLAcceptURL (_: _: _: _: _:) LSCanURLAcceptURL

    Тесты, может ли приложение принять (открывают) элемент, определяемый URL.

    Объявление

    Swift

    func LSCanURLAcceptURL(_ inItemURL: CFURL!, _ inTargetURL: CFURL!, _ inRolesMask: LSRolesMask, _ inFlags: LSAcceptanceFlags, _ outAcceptsItem: UnsafeMutablePointer<Boolean>) -> OSStatus

    Objective C

    OSStatus LSCanURLAcceptURL ( CFURLRef inItemURL, CFURLRef inTargetURL, LSRolesMask inRoleMask, LSAcceptanceFlags inFlags, Boolean *outAcceptsItem );

    Параметры

    inItemURL

    Базовая Основа ссылка URL обозначение исходного элемента (элемент для тестирования на принятие целевым приложением); посмотрите Ссылку CFURL в Базовой Справочной документации Основы для описания CFURLRef тип данных.

    inTargetURL

    Базовая Основа ссылка URL обозначение целевого приложения; посмотрите Ссылку CFURL в Базовой Справочной документации Основы для описания CFURLRef тип данных. URL должен иметь схему file и содержите допустимый путь к файлу приложения или комплекту приложений.

    inRolesMask

    Немного маски, указывающей желаемую роль целевого приложения или роли относительно исходного элемента; посмотрите Ролевую Маску для описания этой маски. Этот параметр применяется только к URLs с компонентом схемы file, и проигнорирован для всех других схем. Если роль неважна, передача kLSRolesAll.

    inFlags

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

    outAcceptsItem

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

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

    Код результата; посмотрите Коды Результата Launch Services.

    Обсуждение

    Если схема URL’s элемента file (определяющий или файл или каталог), приемочное испытание основывается на расширении файла определяемого элемента, типе файла и подписи создателя, вместе с ролью, указанной inRolesMask параметр; иначе, это основывается на схеме URL (такой как http, ftp, или mailto).

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • LSCanRefAcceptItem (_: _: _: _: _:) LSCanRefAcceptItem (OS X v10.10)

    Тесты, может ли приложение принять (открывают) элемент, определяемый ссылкой файловой системы.

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

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

    Объявление

    Swift

    func LSCanRefAcceptItem(_ inItemFSRef: UnsafePointer<FSRef>, _ inTargetFSRef: UnsafePointer<FSRef>, _ inRolesMask: LSRolesMask, _ inFlags: LSAcceptanceFlags, _ outAcceptsItem: UnsafeMutablePointer<Boolean>) -> OSStatus

    Objective C

    OSStatus LSCanRefAcceptItem ( const FSRef *inItemFSRef, const FSRef *inTargetRef, LSRolesMask inRoleMask, LSAcceptanceFlags inFlags, Boolean *outAcceptsItem );

    Параметры

    inItemFSRef

    Указатель на ссылку файловой системы обозначение исходного элемента (элемент для тестирования на принятие целевым приложением); посмотрите Ссылку Файлового менеджера в Документации управления файлами Углерода для описания FSRef тип данных.

    inTargetFSRef

    Указатель на ссылку файловой системы обозначение целевого приложения; посмотрите Ссылку Файлового менеджера в Документации управления файлами Углерода для описания FSRef тип данных.

    inRolesMask

    Немного маски, указывающей желаемую роль целевого приложения или роли относительно исходного элемента; посмотрите Ролевую Маску для описания этой маски. Если роль неважна, передача kLSRolesAll.

    inFlags

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

    outAcceptsItem

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

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

    Код результата; посмотрите Коды Результата Launch Services.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

  • LSCopyApplicationURLsForBundleIdentifier (_: _:) LSCopyApplicationURLsForBundleIdentifier

    Возвраты весь URLs для приложения, соответствующего идентификатору пакета.

    Объявление

    Swift

    func LSCopyApplicationURLsForBundleIdentifier(_ inBundleIdentifier: CFString!, _ outError: UnsafeMutablePointer<Unmanaged<CFError>?>) -> Unmanaged<CFArray>!

    Objective C

    CFArrayRef LSCopyApplicationURLsForBundleIdentifier ( CFStringRef inBundleIdentifier, CFErrorRef *outError );

    Параметры

    inBundleIdentifier

    Идентификатор пакета интереса, такого как «com.apple.finder». Не должен быть NULL.

    outError

    При отказе, наборе к a CFErrorRef описание проблемы. Если Вы не интересуетесь этой информацией, передачей NULL. Вызывающая сторона ответственна за выпуск этого объекта.

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

    Если какие-либо приложения с указанным идентификатором пакета найдены, их URLs возвращается в a CFArrayRef. Если никакое приложение не могло бы быть найдено, NULL возвращается и outError (если нет NULL) заполняется с kLSApplicationNotFoundErr.

    Порядок элементов в массиве не определен.

    Вызывающая сторона ответственна за выпуск этого массива.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • LSFindApplicationForInfo (_: _: _: _: _:) LSFindApplicationForInfo (OS X v10.10)

    Определяет местоположение приложения с указанной подписью создателя, пакет ID, имя файла или любая комбинация этих характеристик.

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

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

    Объявление

    Swift

    func LSFindApplicationForInfo(_ inCreator: OSType, _ inBundleID: CFString!, _ inName: CFString!, _ outAppRef: UnsafeMutablePointer<FSRef>, _ outAppURL: UnsafeMutablePointer<Unmanaged<CFURL>?>) -> OSStatus

    Objective C

    OSStatus LSFindApplicationForInfo ( OSType inCreator, CFStringRef inBundleID, CFStringRef inName, FSRef *outAppRef, CFURLRef *outAppURL );

    Параметры

    inCreator

    Подпись создателя для рассмотрения. Сравнение подписей создателя чувствительно к регистру. Передача kLSUnknownCreator если подпись создателя приложения неважна.

    inBundleID

    Базовая Основа представляет в виде строки объект, указывающий пакет ID для рассмотрения; посмотрите Ссылку CFString в Базовой Справочной документации Основы для описания CFStringRef тип данных. Сравнение пакета IDs нечувствительно к регистру. Передача NULL если пакет приложения ID неважен.

    inName

    Базовая Основа представляет в виде строки объект, указывающий имя файла для рассмотрения; посмотрите Ссылку CFString в Базовой Справочной документации Основы для описания CFStringRef тип данных. Строка должна включать любое расширение (такой как '.app') это - часть имени файла. Сравнение имен файлов нечувствительно к регистру. Передача NULL если имя файла приложения неважно.

    outAppRef

    Указатель на ссылку файловой системы, что, по возврату, идентифицирует требуемое приложение; посмотрите Ссылку Файлового менеджера в Документации управления файлами Углерода для описания FSRef тип данных. Передача NULL если Вы не интересуетесь идентификацией приложения в этой форме; однако, этот параметр и outAppURL не может оба быть NULL.

    outAppURL

    Указатель на Базовую Основу ссылка URL, что, по возврату, идентифицирует требуемое приложение; посмотрите Ссылку CFURL в Базовой Справочной документации Основы для описания CFURLRef тип данных. Передача NULL если Вы не интересуетесь идентификацией приложения в этой форме; однако, этот параметр и outAppRef не может оба быть NULL.

    Несмотря на отсутствие слова Copy на ее имя эта функция сохраняет ссылочный объект URL от Вашего имени; Вы ответственны за выпуск этого объекта.

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

    Код результата; посмотрите Коды Результата Launch Services. Если никакое подходящее приложение не будет найдено в базе данных Launch Services, то функция возвратит код результата kLSApplicationNotFoundErr.

    Обсуждение

    Можно запросить любую комбинацию один, два, или все три из характеристик, указанных inCreator, inBundleID, и inName параметры; по крайней мере одна из этих характеристик должна быть предоставлена. Если больше чем одно приложение найдено, соответствуя заданные характеристики, Launch Services выбирает тот таким же образом, определяя местоположение предпочтительного приложения для открытия элемента.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

Открытие элементов

Функции, описанные в этом разделе, открывают определяемый элемент или набор элементов, или запускают или активируют определяемое приложение.

  • LSOpenApplication (_: _:) LSOpenApplication (OS X v10.10)

    Запускает указанное приложение.

    Объявление

    Swift

    func LSOpenApplication(_ inAppParams: UnsafePointer<LSApplicationParameters>, _ outPSN: UnsafeMutablePointer<ProcessSerialNumber>) -> OSStatus

    Objective C

    OSStatus LSOpenApplication ( const LSApplicationParameters *appParams, ProcessSerialNumber *outPSN );

    Параметры

    inAppParams

    A LSApplicationParameters структура, указывающая приложение для запуска и его параметры запуска. Этот параметр не может быть NULL.

    outPSN

    На вводе, указателе на значение типа ProcessSerialNumber это, по возврату, содержит порядковый номер процесса (PSN) приложения, указанного inAppParams, или NULL если Вы не хотите получать PSN.

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

    Код результата; посмотрите Коды Результата Launch Services.

    Обсуждение

    LSOpenApplication запуски одно приложение. Эта функция является обновленной альтернативой Диспетчеру процессов LaunchApplication функция. Параметры запуска указаны в inAppParams параметр, который должен быть предоставлен. Если приложение уже работает в текущем сеансе, это сделано передним процессом (если kLSLaunchNewInstance флаг используется, который всегда заставляет новый процесс создаваться).

    Если outPSN не NULL, по возврату структура, на которую это указывает, содержит PSN запущенного (или активированный) процесс. Когда эта функция возвращается, Обратите внимание на то, что для асинхронных запусков, приложение могло не закончить запускаться.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

  • LSOpenItemsWithRole (_: _: _: _: _: _: _:) LSOpenItemsWithRole (OS X v10.10)

    Открывает элементы, указанные как массив значений типа FSRef с указанной ролью.

    Объявление

    Swift

    func LSOpenItemsWithRole(_ inItems: UnsafePointer<FSRef>, _ inItemCount: CFIndex, _ inRole: LSRolesMask, _ inAEParam: UnsafePointer<AEKeyDesc>, _ inAppParams: UnsafePointer<LSApplicationParameters>, _ outPSNs: UnsafeMutablePointer<ProcessSerialNumber>, _ inMaxPSNCount: CFIndex) -> OSStatus

    Objective C

    OSStatus LSOpenItemsWithRole ( const FSRef *inItems, CFIndex inItemCount, LSRolesMask inRole, const AEKeyDesc *inAEParam, const LSApplicationParameters *inAppParams, ProcessSerialNumber *outPSNs, CFIndex inMaxPSNCount );

    Параметры

    inItems

    Массив значений типа FSRef.

    inItemCount

    Число элементов, указанных в inItems.

    inRole

    Значение типа LSRolesMask указание одной или более ролей. Если роль не имеет значения, использовать kLSRolesAll. Для возможных значений посмотрите Ролевую Маску. Если inAppParams параметр не NULL, этот параметр проигнорирован.

    inAEParam

    AEKeyDesc это быть присоединено к Событию (ям) Apple, сгенерированному Launch Services с указанным AEKeyword. Этот параметр может быть NULL.

    inAppParams

    LSApplicationParameters структура, указывающая приложение для запуска и его параметры запуска, когда inRole параметр проигнорирован. Этот параметр может быть NULL, когда приложение выбрано, который может обработать каждый входной элемент в по крайней мере одной из ролей, указанных inRole параметр.

    outPSNs

    На вводе, указателе на выделенный вызывающей стороне буфер или NULL если Вы не хотите получать информацию о порядковом номере процесса (PSN). Если нет NULL на вводе, по возврату, буфер содержит в каждом индексе PSN, использовавшийся для открытия элемента в том же индексе входного массива элемента (inItems).

    inMaxPSNCount

    Максимальное количество PSNs, что буфер, которым указывают outPSNs может содержать.

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

    Код результата; посмотрите Коды Результата Launch Services.

    Обсуждение

    Эта функция открывает указанные элементы с указанной ролью. Можно дополнительно указать приложение и запустить параметры в inAppParams параметр. Если приложение указано в inAppParams параметр, inRole параметр проигнорирован, и приложение запускается (если необходимый).

    Каждое приложение (независимо от того, запускается ли это или уже работающий) получает 'odoc' Событие Apple, указывающее элементы, которые должны быть открыты.

    Если inItems массив содержит любые приложения, эта функция запускает их только если kLSRolesShell бит установлен в inRoles параметр, чтобы указать, что операционная система должна использовать само приложение в качестве оболочки выполнения нового процесса.

    Если нет NULL, outPSNs буфер заполнен PSN, использовавшимся для открытия каждого элемента в том же индексе inItems массив. Способность PSN буфера вывода указана inMaxPSNCount.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

  • LSOpenURLsWithRole (_: _: _: _: _: _:) LSOpenURLsWithRole (OS X v10.10)

    Открывает один или несколько URLs с указанными ролями.

    Объявление

    Swift

    func LSOpenURLsWithRole(_ inURLs: CFArray!, _ inRole: LSRolesMask, _ inAEParam: UnsafePointer<AEKeyDesc>, _ inAppParams: UnsafePointer<LSApplicationParameters>, _ outPSNs: UnsafeMutablePointer<ProcessSerialNumber>, _ inMaxPSNCount: CFIndex) -> OSStatus

    Objective C

    OSStatus LSOpenURLsWithRole ( CFArrayRef inURLs, LSRolesMask inRole, const AEKeyDesc *inAEParam, const LSApplicationParameters *inAppParams, ProcessSerialNumber *outPSNs, CFIndex inMaxPSNCount );

    Параметры

    inURLs

    Массив значений типа CFURLRef.

    inRole

    Значение типа LSRolesMask указание одной или более ролей. Если роль не имеет значения, использовать kLSRolesAll. Для возможных значений посмотрите Ролевую Маску. Этот параметр проигнорирован если inAppParams параметр не NULL.

    inAEParam

    Значение типа AEKeyDesc это быть присоединено к Событию (ям) Apple, сгенерированному Launch Services с указанным AEKeyword. Этот параметр может быть NULL.

    inAppParams

    LSApplicationParameters структура, указывающая приложение для запуска и его параметры запуска, когда inRole параметр проигнорирован. Этот параметр может быть NULL, когда приложение выбрано, который может обработать каждый ввод URL в по крайней мере одной из ролей, указанных inRole параметр.

    outPSNs

    На вводе, указателе на выделенный вызывающей стороне буфер или NULL если Вы не хотите получать информацию о порядковом номере процесса (PSN). Если нет NULL на вводе, по возврату, буфер содержит в каждом индексе PSN, использовавшийся для открытия URL в том же индексе ввода массив URL (inURLs).

    inMaxPSNCount

    Максимальное количество PSNs, что буфер, которым указывают outPSNs может содержать.

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

    Код результата; посмотрите Коды Результата Launch Services.

    Обсуждение

    Эта функция открывает URLs, указанный inURLs с ролями, указанными inRole.

    Каждое запущенное приложение получает один или больше 'GURL' События Apple, указывающие URLs, который будет открыт. Можно также передать файл URLs, интерпретированный как элементы файловой системы и открытый способом LSOpenItemsWithRole (т.е. обработчик выбран на основе метаданных файловой системы элемента).If inURLs содержит любое приложение URLs, эта функция запускает их только если kLSRolesShell бит установлен в inRoles параметр, когда приложение является своей собственной оболочкой. Если нет NULL, outPSNs буфер заполнен порядковыми номерами процесса, использовавшимися для открытия каждого URL в том же индексе ввода массив URL, указанный inURLs параметр. Способность PSN буфера вывода указана inMaxPSNCount.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

  • LSOpenFSRef (_: _:) LSOpenFSRef (OS X v10.10)

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

    Объявление

    Swift

    func LSOpenFSRef(_ inRef: UnsafePointer<FSRef>, _ outLaunchedRef: UnsafeMutablePointer<FSRef>) -> OSStatus

    Objective C

    OSStatus LSOpenFSRef ( const FSRef *inRef, FSRef *outLaunchedRef );

    Параметры

    inRef

    Указатель на ссылку файловой системы обозначение элемента открыться; посмотрите Ссылку Файлового менеджера в Документации управления файлами Углерода для описания FSRef тип данных.

    outLaunchedRef

    Указатель на ссылку файловой системы, что, по возврату, идентифицирует запущенное приложение. Передача NULL если эта информация неважна.

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

    Код результата; посмотрите Коды Результата Launch Services.

    Обсуждение

    Определяемый элемент открыт способом по умолчанию, как будто это было открыто с LSOpenFromRefSpec функция со спецификацией запуска, указывающей флаг запуска kLSLaunchDefaults: т.е. асинхронно, запуская Классическую среду эмуляции при необходимости, и с остающимися параметрами запуска, взятыми от информационного списка свойств приложения. Для большего управления вызвать LSOpenFromRefSpec непосредственно. Посмотрите “Launch Flags” для получения дополнительной информации о флагах запуска.

    Заявление запущено или активировано, как требуется, и послано надлежащее событие Apple в зависимости от обстоятельств:

    • Если элемент является документом, его предпочтительное приложение запускается (или активируется, если он уже работает), и отправленный 'odoc' (“открывают документ”), событие Apple.

    • Если элемент является приложением, уже не работающим, он запускается и отправляется 'oapp' («открытое приложение») событие Apple.

    • Если элемент является приложением, уже работающим, он активируется и отправляется 'rapp' (“вновь открывают приложение”), событие Apple.

    С OS X v10.4 и позже, LSOpenItemsWithRole предпочтительный способ открыть элемент.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

  • LSOpenFromRefSpec (_: _:) LSOpenFromRefSpec (OS X v10.10)

    Открывает один или несколько элементов, определяемых ссылкой файловой системы, или в их предпочтительных приложениях или в определяемом приложении.

    Объявление

    Swift

    func LSOpenFromRefSpec(_ inLaunchSpec: UnsafePointer<LSLaunchFSRefSpec>, _ outLaunchedRef: UnsafeMutablePointer<FSRef>) -> OSStatus

    Objective C

    OSStatus LSOpenFromRefSpec ( const LSLaunchFSRefSpec *inLaunchSpec, FSRef *outLaunchedRef );

    Параметры

    inLaunchSpec

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

    outLaunchedRef

    Указатель на ссылку файловой системы, что, по возврату, идентифицирует запущенное приложение; посмотрите Ссылку Файлового менеджера в Документации управления файлами Углерода для описания FSRef тип данных. Передача NULL если эта информация неважна. Если больше чем одно приложение будет запущено, то идентифицированный тот будет тем, соответствующим первому элементу, определяемому в спецификации запуска.

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

    Код результата; посмотрите Коды Результата Launch Services.

    Обсуждение

    Эта функция предоставляет большее управление того, как элементы открыты, или приложения запускаются, чем возможно с LSOpenFSRef функция. Например, можно использовать его для открытия многократных элементов в единственном вызове, или в тех же или в различных приложениях; открытые документы для печати, а не для простого просмотра или редактирования; или вынудите документ открыться в приложении кроме его собственного предпочтительного приложения.

    Спецификация запуска, предоставленная для inLaunchSpec параметр может определять приложение запускаться, элементы для открытия, или оба. Соответствующее приложение или приложения запускаются или активируются, как требуется, и отправляются надлежащее событие Apple в зависимости от обстоятельств:

    • Если спецификация запуска определяет оба элемента открываться и приложение, с которым можно открыть их, определяемое приложение используется для открытия всех элементов. Приложение запускается (или активируется, если оно уже работает), и отправленный 'odoc' (“открывают документ”), событие Apple, содержащее список элементов для открытия; если элементы должны быть распечатаны, событие Apple 'pdoc' (“распечатывают документ”), вместо этого.

    • Если спецификация запуска определяет элементы открываться, но не приложение, с которым можно открыть их, каждый элемент открыт в его собственном предпочтительном приложении. Каждое заявление запущено или активировано и послано 'odoc' или 'pdoc' Событие Apple, как описано для предыдущего случая. (Если два или больше из элементов имеют то же предпочтительное приложение, приложение получает сингл 'odoc' или 'pdoc' список мероприятий все соответствующие элементы.)

    • Если спецификация запуска определяет только приложение запускаться (или если один или больше элементов для открытия приложения):

      • Если приложение уже не работает, оно запускается и отправляется 'oapp' («открытое приложение») событие Apple.

      • Если приложение уже работает, оно активируется и отправляется 'rapp' (“вновь открывают приложение”), событие Apple.

    С OS X v10.4 и позже, LSOpenItemsWithRole предпочтительный способ открыть элементы.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

  • LSOpenCFURLRef (_: _:) LSOpenCFURLRef

    Открывает элемент, определяемый URL, способом по умолчанию в его предпочтительном приложении.

    Объявление

    Swift

    func LSOpenCFURLRef(_ inURL: CFURL!, _ outLaunchedURL: UnsafeMutablePointer<Unmanaged<CFURL>?>) -> OSStatus

    Objective C

    OSStatus LSOpenCFURLRef ( CFURLRef inURL, CFURLRef *outLaunchedURL );

    Параметры

    inURL

    Базовая Основа ссылка URL обозначение элемента открыться; посмотрите Ссылку CFURL в Базовой Справочной документации Основы для описания CFURLRef тип данных.

    outLaunchedURL

    Указатель на Базовую Основу ссылка URL, что, по возврату, идентифицирует запущенное приложение. Передача NULL если эта информация неважна.

    Несмотря на отсутствие слова Copy на ее имя эта функция сохраняет ссылочный объект URL от Вашего имени; Вы ответственны за выпуск этого объекта.

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

    Код результата; посмотрите Коды Результата Launch Services.

    Обсуждение

    Определяемый элемент открыт способом по умолчанию, как будто это было открыто с LSOpenFromURLSpec функция со спецификацией запуска, указывающей флаг запуска kLSLaunchDefaults: т.е. асинхронно, запуская Классическую среду эмуляции при необходимости, и с остающимися параметрами запуска, взятыми от информационного списка свойств приложения. Для большего управления вызвать LSOpenFromURLSpec непосредственно. Посмотрите “Launch Flags” для получения дополнительной информации о флагах запуска.

    Если схема URL’s элемента file (определяющий или файл или каталог), выбор предпочтительного приложения основывается на расширении файла определяемого элемента, типе файла и подписи создателя; иначе, это основывается на схеме URL (такой как http, ftp, или mailto). Заявление запущено или активировано, как требуется, и послано надлежащее событие Apple в зависимости от обстоятельств:

    • Если схема URL’s file и это определяет документ, предпочтительное приложение документа запускается (или активируется, если это уже работает).

      • Если приложение утверждает, что приняло file URLs, это отправляется a 'GURL' (“получают URL”), событие Apple, содержащее URL элемента.

      • Если приложение не утверждает, что приняло file URLs, это отправляется 'odoc' (“открывают документ”), событие Apple, идентифицирующее документ для открытия.

    • Если схема URL’s file и это определяет приложение:

      • Если приложение уже не работает, оно запускается и отправляется 'oapp' («открытое приложение») событие Apple.

      • Если приложение уже работает, оно активируется и отправляется 'rapp' (“вновь открывают приложение”), событие Apple.

    • Если URL имеет схему кроме file, предпочтительное приложение схемы запускается (или активируется, если оно уже работает), и отправленный a 'GURL' (“получают URL”), событие Apple, содержащее URL элемента.

    С OS X v10.4 и позже, LSOpenURLsWithRole предпочтительный способ открытие URL.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • LSOpenFromURLSpec (_: _:) LSOpenFromURLSpec

    Открывает один или несколько элементов, определяемых URL, или в их предпочтительных приложениях или в определяемом приложении.

    Объявление

    Swift

    func LSOpenFromURLSpec(_ inLaunchSpec: UnsafePointer<LSLaunchURLSpec>, _ outLaunchedURL: UnsafeMutablePointer<Unmanaged<CFURL>?>) -> OSStatus

    Objective C

    OSStatus LSOpenFromURLSpec ( const LSLaunchURLSpec *inLaunchSpec, CFURLRef *outLaunchedURL );

    Параметры

    inLaunchSpec

    Указатель на ОСНОВАННУЮ НА URL спецификацию запуска, указывающую, что открыться и как запустить соответствующее приложение или приложения; посмотрите LSLaunchURLSpec для описания этой структуры.

    outLaunchedURL

    Указатель на Базовую Основу ссылка URL, что, по возврату, идентифицирует запущенное приложение; посмотрите Ссылку CFURL в Базовой Справочной документации Основы для описания CFURLRef тип данных. Передача NULL если эта информация неважна. Если больше чем одно приложение будет запущено, то идентифицированный тот будет тем, соответствующим первому элементу, определяемому в спецификации запуска.

    Несмотря на отсутствие слова Copy на ее имя эта функция сохраняет ссылочный объект URL от Вашего имени; Вы ответственны за выпуск этого объекта.

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

    Код результата; посмотрите Коды Результата Launch Services.

    Обсуждение

    Эта функция предоставляет большее управление того, как элементы открыты, или приложения запускаются, чем возможно с LSOpenCFURLRef функция. Например, можно использовать его для открытия многократных элементов в единственном вызове, или в тех же или в различных приложениях; открытые документы для печати, а не для простого просмотра или редактирования; или вынудите документ открыться в приложении кроме его собственного предпочтительного приложения.

    Спецификация запуска, предоставленная для inLaunchSpec параметр может определять приложение запускаться, элементы для открытия, или оба. Соответствующее приложение или приложения запускаются или активируются, как требуется, и отправляются надлежащее событие Apple в зависимости от обстоятельств:

    • Если спецификация запуска определяет оба элемента открываться и приложение, с которым можно открыть их, определяемое приложение используется для открытия всех элементов. Приложение запускается (или активируется, если оно уже работает), и отправил одно или более событий Apple:

      • Если один или больше элемента URLs имеет схему file и определяйте документы открываться, и если приложение утверждает, что приняло file URLs, это отправляется a 'GURL' (“получают URL”), событие Apple для каждого такого URL.

      • Если один или больше элемента URLs имеет схему file и определяйте документы открываться, и если приложение не утверждает, что приняло file URLs, это отправляется сингл 'odoc' (“открывают документ”), событие Apple, содержащее список элементов для открытия; если элементы должны быть распечатаны, событие Apple 'pdoc' (“распечатывают документ”), вместо этого.

      • Для каждого элемента URL со схемой кроме file, заявление послано a 'GURL' (“получают URL”), событие Apple, содержащее URL элемента.

    • Если спецификация запуска определяет элементы открываться, но не приложение, с которым можно открыть их, каждый элемент открыт в его собственном предпочтительном приложении. Каждое заявление запущено или активировано и послано одно или более событий Apple, как описано для предыдущего случая. (Если два или больше из элементов имеют то же предпочтительное приложение, приложение получает сингл 'odoc' или 'pdoc' список мероприятий все соответствующие элементы.)

    • Если спецификация запуска определяет только приложение запускаться (или если один или больше элементов для открытия file Приложения обозначения URLs):

      • Если приложение уже не работает, оно запускается и отправляется 'oapp' («открытое приложение») событие Apple.

      • Если приложение уже работает, оно активируется и отправляется 'rapp' (“вновь открывают приложение”), событие Apple.

    С OS X v10.4 и позже, LSOpenURLsWithRole предпочтительный способ открытие URLs.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

Получение информации об элементе

Функции, описанные в этом разделе, получают запрошенную информацию об элементе.

  • LSCopyItemInfoForRef (_: _: _:) LSCopyItemInfoForRef (OS X v10.10)

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

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

    Использовать LSCopyItemInfoForURL или свойства ресурса URL вместо этого.

    Объявление

    Swift

    func LSCopyItemInfoForRef(_ inItemRef: UnsafePointer<FSRef>, _ inWhichInfo: LSRequestedInfo, _ outItemInfo: UnsafeMutablePointer<LSItemInfoRecord>) -> OSStatus

    Objective C

    OSStatus LSCopyItemInfoForRef ( const FSRef *inItemRef, LSRequestedInfo inWhichInfo, LSItemInfoRecord *outItemInfo );

    Параметры

    inItemRef

    Указатель на ссылку файловой системы обозначение элемента, о котором запрошена информация; посмотрите Ссылку Файлового менеджера в Документации управления файлами Углерода для описания FSRef тип данных.

    inWhichInfo

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

    outItemInfo

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

    Если Вы запрашиваете расширение файла элемента (поле extension из информационной записи элемента, которую требует флаг kLSRequestExtension), Вы ответственны за выпуск Базового строкового объекта Основы, в котором возвращается расширение.

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

    Код результата; посмотрите Коды Результата Launch Services.

    Обсуждение

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

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

  • LSCopyItemInfoForURL (_: _: _:) LSCopyItemInfoForURL

    Получает запрошенную информацию об элементе, определяемом URL.

    Объявление

    Swift

    func LSCopyItemInfoForURL(_ inFileURL: CFURL!, _ inWhichInfo: LSRequestedInfo, _ outItemInfo: UnsafeMutablePointer<LSItemInfoRecord>) -> OSStatus

    Objective C

    OSStatus LSCopyItemInfoForURL ( CFURLRef inURL, LSRequestedInfo inWhichInfo, LSItemInfoRecord *outItemInfo );

    Параметры

    inFileURL

    Базовое ссылочное обозначение URL Основы элемента, о котором запрошена информация; посмотрите Ссылку CFURL в Базовой Справочной документации Основы для описания CFURLRef тип данных. URL должен иметь схему file и содержите допустимый путь или к файлу или к каталогу.

    inWhichInfo

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

    outItemInfo

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

    Если Вы запрашиваете расширение файла элемента (поле extension из информационной записи элемента, которую требует флаг kLSRequestExtension), Вы ответственны за выпуск Базового строкового объекта Основы, в котором возвращается расширение.

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

    Код результата; посмотрите Коды Результата Launch Services.

    Обсуждение

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

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • LSCopyDisplayNameForRef (_: _:) LSCopyDisplayNameForRef (OS X v10.10)

    Получает имя дисплея для элемента, определяемого ссылкой файловой системы.

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

    Использовать LSCopyDisplayNameForURL или свойство ресурса URL kCFURLLocalizedNameKey/NSURLLocalizedNameKey вместо этого.

    Объявление

    Swift

    func LSCopyDisplayNameForRef(_ inRef: UnsafePointer<FSRef>, _ outDisplayName: UnsafeMutablePointer<Unmanaged<CFString>?>) -> OSStatus

    Objective C

    OSStatus LSCopyDisplayNameForRef ( const FSRef *inRef, CFStringRef *outDisplayName );

    Параметры

    inRef

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

    outDisplayName

    Указатель на Базовую строку Основы объект, что, по возврату, будет содержать имя дисплея элемента; посмотрите Ссылку CFString в Базовой Справочной документации Основы для описания CFStringRef тип данных. Вы ответственны за выпуск этого объекта.

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

    Код результата; посмотрите Коды Результата Launch Services.

    Обсуждение

    Имя дисплея элемента возвращается в форме, в которой это появится на экране пользователя; это может быть локализовано (для приложений и папок), и это исключает расширение файла, если расширение установлено быть скрытым и предпочтение Средства поиска, чтобы всегда показать, что не включены расширения.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

  • LSCopyDisplayNameForURL (_: _:) LSCopyDisplayNameForURL

    Получает имя дисплея для элемента, определяемого URL.

    Объявление

    Swift

    func LSCopyDisplayNameForURL(_ inFileURL: CFURL!, _ outDisplayName: UnsafeMutablePointer<Unmanaged<CFString>?>) -> OSStatus

    Objective C

    OSStatus LSCopyDisplayNameForURL ( CFURLRef inURL, CFStringRef *outDisplayName );

    Параметры

    inFileURL

    Базовое ссылочное обозначение URL Основы элемента, имя дисплея которого требуют; посмотрите Ссылку CFURL в Базовой Справочной документации Основы для описания CFURLRef тип данных. URL должен иметь схему file и содержите допустимый путь или к файлу или к каталогу.

    outDisplayName

    Указатель на Базовую строку Основы объект, что, по возврату, будет содержать имя дисплея элемента; посмотрите Ссылку CFString в Базовой Справочной документации Основы для описания CFStringRef тип данных. Вы ответственны за выпуск этого объекта.

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

    Код результата; посмотрите Коды Результата Launch Services.

    Обсуждение

    Имя дисплея элемента возвращается в форме, в которой это появится на экране пользователя; это может быть локализовано (для приложений и папок), и это исключает расширение файла, если расширение установлено быть скрытым и предпочтение Средства поиска, чтобы всегда показать, что не включены расширения.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • LSCopyKindStringForRef (_: _:) LSCopyKindStringForRef (OS X v10.10)

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

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

    Использовать LSCopyKindStringForURL или свойство ресурса URL kCFURLLocalizedTypeDescriptionKey/NSURLLocalizedTypeDescriptionKey вместо этого.

    Объявление

    Swift

    func LSCopyKindStringForRef(_ inFSRef: UnsafePointer<FSRef>, _ outKindString: UnsafeMutablePointer<Unmanaged<CFString>?>) -> OSStatus

    Objective C

    OSStatus LSCopyKindStringForRef ( const FSRef *inFSRef, CFStringRef *outKindString );

    Параметры

    inFSRef

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

    outKindString

    Указатель на Базовую строку Основы объект, что, по возврату, будет содержать добрую строку элемента; посмотрите Ссылку CFString в Базовой Справочной документации Основы для описания CFStringRef тип данных. Вы ответственны за выпуск этого объекта.

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

    Код результата; посмотрите Коды Результата Launch Services.

    Обсуждение

    Добрая строка (который может быть локализован) получена из предпочтительного приложения элемента, если Вы найдены в базе данных Launch Services; иначе, более универсальная добрая строка выбрана. Например, добрая строка могла бы быть FrameMaker Document, или просто Document если элемент является документом, для которого не найдено никакое приложение.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

  • LSCopyKindStringForURL (_: _:) LSCopyKindStringForURL

    Получает добрую строку для элемента, определяемого URL.

    Объявление

    Swift

    func LSCopyKindStringForURL(_ inURL: CFURL!, _ outKindString: UnsafeMutablePointer<Unmanaged<CFString>?>) -> OSStatus

    Objective C

    OSStatus LSCopyKindStringForURL ( CFURLRef inURL, CFStringRef *outKindString );

    Параметры

    inURL

    Базовое ссылочное обозначение URL Основы элемента, добрую строку которого требуют; посмотрите Ссылку CFURL в Базовой Справочной документации Основы для описания CFURLRef тип данных.

    outKindString

    Указатель на Базовую строку Основы объект, что, по возврату, будет содержать добрую строку элемента; посмотрите Ссылку CFString в Базовой Справочной документации Основы для описания CFStringRef тип данных. Вы ответственны за выпуск этого объекта.

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

    Код результата; посмотрите Коды Результата Launch Services.

    Обсуждение

    Добрая строка (который может быть локализован) получена из предпочтительного приложения элемента, если Вы найдены в базе данных Launch Services; иначе, более универсальная добрая строка выбрана. Например, добрая строка могла бы быть FrameMaker Document, или просто Document если элемент является документом, для которого не найдено никакое приложение. Если схема URL’s элемента file (определяющий или файл или каталог), выбор предпочтительного приложения основывается на расширении файла определяемого элемента, типе файла и подписи создателя; иначе, это основывается на схеме URL (такой как http, ftp, или mailto).

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • LSCopyKindStringForTypeInfo (_: _: _: _:) LSCopyKindStringForTypeInfo (OS X v10.10)

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

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

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

    Объявление

    Swift

    func LSCopyKindStringForTypeInfo(_ inType: OSType, _ inCreator: OSType, _ inExtension: CFString!, _ outKindString: UnsafeMutablePointer<Unmanaged<CFString>?>) -> OSStatus

    Objective C

    OSStatus LSCopyKindStringForTypeInfo ( OSType inType, OSType inCreator, CFStringRef inExtension, CFStringRef *outKindString );

    Параметры

    inType

    Тип файла для рассмотрения. Сравнение типов файлов чувствительно к регистру. Передача kLSUnknownType если тип файла элементов неважен.

    inCreator

    Подпись создателя для рассмотрения. Сравнение подписей создателя чувствительно к регистру. Передача kLSUnknownCreator если подпись создателя элементов неважна.

    inExtension

    Базовая Основа представляет в виде строки объект, указывающий расширение файла для рассмотрения; посмотрите Ссылку CFString в Базовой Справочной документации Основы для описания CFStringRef тип данных. Сравнение расширений файла нечувствительно к регистру. Передача NULL если расширение файла элементов неважно.

    outKindString

    Указатель на Базовую строку Основы объект, что, по возврату, будет содержать требуемую добрую строку; посмотрите Ссылку CFString в Базовой Справочной документации Основы для описания CFStringRef тип данных. Вы ответственны за выпуск этого объекта.

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

    Код результата; посмотрите Коды Результата Launch Services.

    Обсуждение

    Эта функция получает добрую строку, наиболее близко описывающую элементы, имеющие заданные характеристики. Полезно, когда Вы хотите вывести на экран добрую строку для документа, Вы еще не имеете (такие как почтовое присоединение).

    Можно запросить любую комбинацию один, два, или все три из характеристик, указанных inType, inCreator, и inExtension параметры; по крайней мере одна из этих характеристик должна быть предоставлена. Добрая строка (который может быть локализован) получена из предпочтительного приложения для открытия таких элементов, если Вы найдены в базе данных Launch Services; иначе, более универсальная добрая строка выбрана. Например, добрая строка могла бы быть FrameMaker Document, или просто Document если не найдено никакое подходящее приложение.

    Обратите внимание на то, что, так как выбор предпочтительного приложения подвергается любому документу обязательные предпочтения, которые, возможно, установил пользователь, добрая строка будет не обязательно получена из приложения по умолчанию, которое соответствует указанную подпись создателя (если таковые имеются), но может вместо этого быть взято из указанного пользователями приложения, переопределяющего значение по умолчанию. Например, если пользователь указал это файлы типа 'PDF ' и создатель 'ACRO' должен быть открыт в приложении Предварительного просмотра, а не в Acrobat, добрая строка для этой комбинации характеристик будет определенным для 'PDF ' файлы Предварительным просмотром а не Acrobat.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

  • LSCopyKindStringForMIMEType (_: _:) LSCopyKindStringForMIMEType (OS X v10.10)

    Получает добрую строку для указанного типа MIME.

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

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

    Объявление

    Swift

    func LSCopyKindStringForMIMEType(_ inMIMEType: CFString!, _ outKindString: UnsafeMutablePointer<Unmanaged<CFString>?>) -> OSStatus

    Objective C

    OSStatus LSCopyKindStringForMIMEType ( CFStringRef inMIMEType, CFStringRef *outKindString );

    Параметры

    inMIMEType

    Базовая Основа представляет в виде строки объект, указывающий тип MIME, добрую строку которого требуют; посмотрите Ссылку CFString в Базовой Справочной документации Основы для описания CFStringRef тип данных. Сравнение типов MIME нечувствительно к регистру.

    outKindString

    Указатель на Базовую строку Основы объект, что, по возврату, будет содержать добрую строку для указанного типа MIME; посмотрите Ссылку CFString в Базовой Справочной документации Основы для описания CFStringRef тип данных. Вы ответственны за выпуск этого объекта.

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

    Код результата; посмотрите Коды Результата Launch Services.

    Обсуждение

    Добрая строка (который может быть локализован) получена из предпочтительного приложения для вводных элементов указанного тип MIME, если Вы найдены в базе данных Launch Services; иначе, более универсальная добрая строка выбрана.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

  • LSCopyItemAttribute (_: _: _: _:) LSCopyItemAttribute (OS X v10.10)

    Получает значение атрибута элемента.

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

    Использовать CFURLCopyResourcePropertyForKey или getResourceValue:forKey:error: вместо этого.

    Объявление

    Swift

    func LSCopyItemAttribute(_ inItem: UnsafePointer<FSRef>, _ inRoles: LSRolesMask, _ inAttributeName: CFString!, _ outValue: UnsafeMutablePointer<Unmanaged<AnyObject>?>) -> OSStatus

    Objective C

    OSStatus LSCopyItemAttribute ( const FSRef *inItem, LSRolesMask inRoles, CFStringRef inAttributeName, CFTypeRef *outValue );

    Параметры

    inItem

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

    inRoles

    Роли. Когда получение атрибутов имело отношение к привязке документа (такой как kLSItemRoleHandlerDisplayName), по крайней мере одна из ролей должна быть предоставлена выбранным приложением. Передача kLSRolesAll если какая-либо роль приемлема.

    inAttributeName

    Имя атрибута для копирования. Для возможных значений посмотрите Константы Атрибута Элемента.

    outValue

    Указатель на a CFTypeRef. По возврату, CFTypeRef установлен в скопированное значение атрибута (объект CF) или NULL если происходит ошибка. Тип возвращенного объекта варьируется в зависимости от атрибута, который требуют.

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

    Код результата; посмотрите Коды Результата Launch Services.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

  • LSCopyItemAttributes (_: _: _: _:) LSCopyItemAttributes (OS X v10.10)

    Получает многократные значения атрибута элемента как словарь.

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

    Использовать CFURLCopyResourcePropertiesForKeys или resourceValuesForKeys:error: вместо этого.

    Объявление

    Swift

    func LSCopyItemAttributes(_ inItem: UnsafePointer<FSRef>, _ inRoles: LSRolesMask, _ inAttributeNames: CFArray!, _ outValues: UnsafeMutablePointer<Unmanaged<CFDictionary>?>) -> OSStatus

    Objective C

    OSStatus LSCopyItemAttributes ( const FSRef *inItem, LSRolesMask inRoles, CFArrayRef inAttributeNames, CFDictionaryRef *outValues );

    Параметры

    inItem

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

    inRoles

    Роли. Когда получение атрибутов имело отношение к привязке документа (такой как kLSItemRoleHandlerDisplayName), по крайней мере одна из ролей должна быть предоставлена выбранным приложением. Передача kLSRolesAll если какая-либо роль приемлема.

    inAttributeNames

    A CFArrayRef для массива, содержащего названия атрибута для копирования. Для возможных значений посмотрите Константы Атрибута Элемента.

    outValues

    По возврату, указатель a CFDictionaryRef для словаря, ключи которого являются названиями атрибута, указанными inAttributeNames параметр и чьи значения являются значениями атрибута. CFTypeID из каждого значения в словаре варьируется атрибутом. Посмотрите Константы Атрибута Элемента для типа данных каждого значения. Если элемент не имеет указанного атрибута, ключ для атрибута не находится в словаре.

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

    Код результата; посмотрите Коды Результата Launch Services.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

Получение и установка информации о расширении файла

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

  • LSGetExtensionInfo (_: _: _:) LSGetExtensionInfo

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

    Объявление

    Swift

    func LSGetExtensionInfo(_ inNameLen: UniCharCount, _ inNameBuffer: UnsafePointer<UniChar>, _ outExtStartIndex: UnsafeMutablePointer<UniCharCount>) -> OSStatus

    Objective C

    OSStatus LSGetExtensionInfo ( UniCharCount inNameLen, const UniChar inNameBuffer[], UniCharCount *outExtStartIndex );

    Параметры

    inNameLen

    Число символов в имени файла, указанном inNameBuffer параметр.

    inNameBuffer

    Буфер, содержащий символы Unicode имени файла.

    outExtStartIndex

    Указатель на значение типа UniCharCount это, по возврату, даст начальное значение индекса расширения в имени файла. Если имя не будет содержать допустимое расширение (один без пробелов в нем), то значение по возврату будет kLSInvalidExtensionIndex.

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

    Код результата; посмотрите Коды Результата Launch Services.

    Обсуждение

    Начальное значение индекса является числом символов Unicode от запуска буфера имени файла к первому символу расширения (не включая период).

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • LSSetExtensionHiddenForRef (_: _:) LSSetExtensionHiddenForRef (OS X v10.10)

    Указывает, должно ли расширение файла для элемента, определяемого ссылкой файловой системы, быть скрыто или показано.

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

    Использовать LSSetExtensionHiddenForURL или свойство ресурса URL kCFURLHasHiddenExtensionKey/NSURLHasHiddenExtensionKey вместо этого.

    Объявление

    Swift

    func LSSetExtensionHiddenForRef(_ inRef: UnsafePointer<FSRef>, _ inHide: Boolean) -> OSStatus

    Objective C

    OSStatus LSSetExtensionHiddenForRef ( const FSRef *inRef, Boolean inHide );

    Параметры

    inRef

    Указатель на ссылку файловой системы обозначение элемента, расширение файла которого должно быть скрыто или показано; посмотрите Ссылку Файлового менеджера в Документации управления файлами Углерода для описания FSRef тип данных.

    inHide

    Булево значение, указывающее, должно ли расширение файла быть скрыто (true) или показанный (false).

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

    Код результата; посмотрите Коды Результата Launch Services. Функция возвратит код результата kLSCannotSetInfoErr если:

    • Расширение не допустимо (содержит пробелы),

    • Расширение не активно (не требуется приложением, зарегистрированным в Launch Services),

    • Сокрытие расширения заставило бы имя файла, казаться, иметь активное, но неправильное расширение (например, в имени файла Photo.jpeg.scpt, где сокрытие расширения заставило бы файл AppleScript, казаться, быть файлом JPEG),

    Обсуждение

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

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

  • LSSetExtensionHiddenForURL (_: _:) LSSetExtensionHiddenForURL

    Указывает, должно ли расширение файла для элемента, определяемого URL, быть скрыто или показано.

    Объявление

    Swift

    func LSSetExtensionHiddenForURL(_ inFileURL: CFURL!, _ inHide: Boolean) -> OSStatus

    Objective C

    OSStatus LSSetExtensionHiddenForURL ( CFURLRef inURL, Boolean inHide );

    Параметры

    inFileURL

    Базовое ссылочное обозначение URL Основы элемента, расширение файла которого должно быть скрыто или показано; посмотрите Ссылку CFURL в Базовой Справочной документации Основы для описания CFURLRef тип данных. URL должен иметь схему file и содержите допустимый путь или к файлу или к каталогу.

    inHide

    Булево значение, указывающее, должно ли расширение быть скрыто (true) или показанный (false).

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

    Код результата; посмотрите Коды Результата Launch Services. Функция возвратит код результата kLSCannotSetInfoErr если:

    • Расширение не допустимо (содержит пробелы),

    • Расширение не активно (не требуется приложением, зарегистрированным в Launch Services),

    • Сокрытие расширения заставило бы имя файла, казаться, иметь активное, но неправильное расширение (например, в имени файла Photo.jpeg.scpt, где сокрытие расширения заставило бы файл AppleScript, казаться, быть файлом JPEG),

    Обсуждение

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

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

Регистрация приложения

Функции, описанные в этом разделе, регистрируют приложение в базе данных Launch Services.

  • LSRegisterURL (_: _:) LSRegisterURL

    Регистрирует приложение, определяемое URL, в базе данных Launch Services.

    Объявление

    Swift

    func LSRegisterURL(_ inFileURL: CFURL!, _ inUpdate: Boolean) -> OSStatus

    Objective C

    OSStatus LSRegisterURL ( CFURLRef inURL, Boolean inUpdate );

    Параметры

    inFileURL

    Базовая Основа ссылка URL обозначение приложения быть зарегистрированным; посмотрите Ссылку CFURL в Базовой Справочной документации Основы для описания CFURLRef тип данных. URL должен иметь схему file и содержите допустимый путь к файлу приложения или комплекту приложений.

    inUpdate

    Булево значение, указывающее, должна ли Launch Services обновить существующую информацию, зарегистрированную для приложения, если таковые имеются. Если этот параметр false, приложение не будет зарегистрировано, если оно было уже зарегистрировано ранее, и его текущая дата модификации не изменилась от того, когда оно было в последний раз зарегистрировано; если параметр true, даже если ее дата модификации не изменилась, зарегистрированная информация приложения будет обновлена.

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

    Код результата; посмотрите Коды Результата Launch Services.

    Обсуждение

    Эта функция добавляет определяемое приложение и его документ и претензии URL (если таковые имеются) к базе данных Launch Services, подавая заявку кандидат на привязку URL и документ.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • LSRegisterFSRef (_: _:) LSRegisterFSRef (OS X v10.10)

    Регистрирует приложение, определяемое ссылкой файловой системы, в базе данных Launch Services.

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

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

    Объявление

    Swift

    func LSRegisterFSRef(_ inRef: UnsafePointer<FSRef>, _ inUpdate: Boolean) -> OSStatus

    Objective C

    OSStatus LSRegisterFSRef ( const FSRef *inRef, Boolean inUpdate );

    Параметры

    inRef

    Указатель на ссылку файловой системы обозначение приложения быть зарегистрированным; посмотрите Ссылку Файлового менеджера в Документации управления файлами Углерода для описания FSRef тип данных.

    inUpdate

    Булево значение, указывающее, должна ли Launch Services обновить существующую информацию, зарегистрированную для приложения, если таковые имеются. Если этот параметр false, приложение не будет зарегистрировано, если оно было уже зарегистрировано ранее, и его текущая дата модификации не изменилась от того, когда оно было в последний раз зарегистрировано; если параметр true, даже если ее дата модификации не изменилась, зарегистрированная информация приложения будет обновлена.

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

    Код результата; посмотрите Коды Результата Launch Services.

    Обсуждение

    Эта функция добавляет определяемое приложение и его документ и претензии URL (если таковые имеются) к базе данных Launch Services, подавая заявку кандидат на привязку URL и документ.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

Работа с ролевыми обработчиками

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

  • LSCopyAllRoleHandlersForContentType (_: _:) LSCopyAllRoleHandlersForContentType

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

    Объявление

    Swift

    func LSCopyAllRoleHandlersForContentType(_ inContentType: CFString!, _ inRole: LSRolesMask) -> Unmanaged<CFArray>!

    Objective C

    CFArrayRef LSCopyAllRoleHandlersForContentType ( CFStringRef inContentType, LSRolesMask inRole );

    Параметры

    inContentType

    Тип контента. Тип контента является универсальным идентификатором типа (UTI).

    inRole

    Роль. Передача kLSRolesAll если какая-либо роль приемлема. Для дополнительных возможных значений посмотрите Ролевую Маску.

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

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

    Обсуждение

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

    CFBundleDocumentTypes введите приложение Info.plist может использоваться для установки содержания приложения обработка возможностей. LSItemContentTypes ключ особенно полезен, потому что он поддерживает использование UTIs в требованиях документа. Для получения информации о CFBundleDocumentTypes ключ, посмотрите раздел «CFBundleDocumentTypes» в Инструкциях по Конфигурации Времени выполнения OS X.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • LSCopyDefaultRoleHandlerForContentType (_: _:) LSCopyDefaultRoleHandlerForContentType

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

    Объявление

    Swift

    func LSCopyDefaultRoleHandlerForContentType(_ inContentType: CFString!, _ inRole: LSRolesMask) -> Unmanaged<CFString>!

    Objective C

    CFStringRef LSCopyDefaultRoleHandlerForContentType ( CFStringRef inContentType, LSRolesMask inRole );

    Параметры

    inContentType

    Тип контента. Тип контента является универсальным идентификатором типа (UTI).

    inRole

    Роль. Передача kLSRolesAll если какая-либо роль приемлема. Для дополнительных возможных значений посмотрите Ролевую Маску.

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

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

    Обсуждение

    Эта функция возвращает в настоящее время предпочтительный обработчик пользователя по умолчанию для указанного типа контента. Скажите, например, это LSSetDefaultRoleHandlerForContentType использовался для установки “com. Apple. TextEdit” для «public.xml» типа контента. Когда по файлу, тип контента которого является «public.xml», дважды щелкнут, TextEdit будет запущен для открытия файла. Если Вы вызываете LSCopyDefaultRoleHandlerForContentType (CFSTR(“public.xml”), kLSRolesAll), строка com.apple.TextEdit возвращается.

    CFBundleDocumentTypes введите приложение Info.plist может использоваться для установки содержания приложения обработка возможностей. LSItemContentTypes ключ особенно полезен, потому что он поддерживает использование UTIs в требованиях документа. Для получения информации о CFBundleDocumentTypes ключ, посмотрите раздел «CFBundleDocumentTypes» в Инструкциях по Конфигурации Времени выполнения OS X.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • LSSetDefaultRoleHandlerForContentType (_: _: _:) LSSetDefaultRoleHandlerForContentType

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

    Объявление

    Swift

    func LSSetDefaultRoleHandlerForContentType(_ inContentType: CFString!, _ inRole: LSRolesMask, _ inHandlerBundleID: CFString!) -> OSStatus

    Objective C

    OSStatus LSSetDefaultRoleHandlerForContentType ( CFStringRef inContentType, LSRolesMask inRole, CFStringRef inHandlerBundleID );

    Параметры

    inContentType

    Тип контента, для которого устанавливается ролевой обработчик по умолчанию. Тип контента является универсальным идентификатором типа (UTI).

    inRole

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

    inHandlerBundleID

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

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

    Код результата; посмотрите Коды Результата Launch Services.

    Обсуждение

    Вызвать LSCopyDefaultRoleHandlerForContentType получить текущую установку предпочтительного обработчика пользователя по умолчанию для указанного типа контента.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • LSGetHandlerOptionsForContentType (_:) LSGetHandlerOptionsForContentType

    Получает опции обработчика для указанного типа контента.

    Объявление

    Swift

    func LSGetHandlerOptionsForContentType(_ inContentType: CFString!) -> LSHandlerOptions

    Objective C

    LSHandlerOptions LSGetHandlerOptionsForContentType ( CFStringRef inContentType );

    Параметры

    inContentType

    Тип контента, для которого состоят в том, чтобы быть получены опции обработчика. Тип контента является универсальным идентификатором типа (UTI).

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

    Опция обработчика, установленная для указанного типа контента. Для возможных значений посмотрите Константы Опции Обработчика.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • LSSetHandlerOptionsForContentType (_: _:) LSSetHandlerOptionsForContentType

    Устанавливает опцию обработчика для указанного типа контента.

    Объявление

    Swift

    func LSSetHandlerOptionsForContentType(_ inContentType: CFString!, _ inOptions: LSHandlerOptions) -> OSStatus

    Objective C

    OSStatus LSSetHandlerOptionsForContentType ( CFStringRef inContentType, LSHandlerOptions inOptions );

    Параметры

    inContentType

    Тип контента, для которого состоят в том, чтобы быть установлены опции обработчика. Тип контента является универсальным идентификатором типа (UTI).

    inOptions

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

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

    Код результата; посмотрите Коды Результата Launch Services.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • LSCopyAllHandlersForURLScheme (_:) LSCopyAllHandlersForURLScheme

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

    Объявление

    Swift

    func LSCopyAllHandlersForURLScheme(_ inURLScheme: CFString!) -> Unmanaged<CFArray>!

    Objective C

    CFArrayRef LSCopyAllHandlersForURLScheme ( CFStringRef inURLScheme );

    Параметры

    inURLScheme

    Схема URL, для которой должны быть возвращены идентификаторы комплекта приложений.

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

    Массив, содержащий идентификаторы комплекта приложений для приложений, способных к обработке схемы URL, указанной inURLScheme, или NULL если никакие обработчики не доступны.

    Обсуждение

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

    Возможность обработки URL определяется согласно значению CFBundleURLTypes введите приложение Info.plist. Для получения информации о CFBundleURLTypes ключ, посмотрите раздел «CFBundleURLTypes» в Инструкциях по Конфигурации Времени выполнения OS X.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • LSCopyDefaultHandlerForURLScheme (_:) LSCopyDefaultHandlerForURLScheme

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

    Объявление

    Swift

    func LSCopyDefaultHandlerForURLScheme(_ inURLScheme: CFString!) -> Unmanaged<CFString>!

    Objective C

    CFStringRef LSCopyDefaultHandlerForURLScheme ( CFStringRef inURLScheme );

    Параметры

    inURLScheme

    Схема URL, для которой должен быть возвращен идентификатор комплекта приложений.

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

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

    Обсуждение

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

    Возможность обработки URL определяется согласно значению CFBundleURLTypes введите приложение Info.plist. Для получения информации о CFBundleURLTypes ключ, посмотрите раздел «CFBundleURLTypes» в Инструкциях по Конфигурации Времени выполнения OS X.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • LSSetDefaultHandlerForURLScheme (_: _:) LSSetDefaultHandlerForURLScheme

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

    Объявление

    Swift

    func LSSetDefaultHandlerForURLScheme(_ inURLScheme: CFString!, _ inHandlerBundleID: CFString!) -> OSStatus

    Objective C

    OSStatus LSSetDefaultHandlerForURLScheme ( CFStringRef inURLScheme, CFStringRef inHandlerBundleID );

    Параметры

    inURLScheme

    Схема URL, для которой должен быть установлен обработчик.

    inHandlerBundleID

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

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

    Код результата; посмотрите Коды Результата Launch Services.

    Обсуждение

    Вызвать LSCopyDefaultHandlerForURLScheme получить текущую установку предпочтительного обработчика пользователя по умолчанию для указанного типа контента.

    Возможность обработки URL определяется согласно значению CFBundleURLTypes введите приложение Info.plist. Для получения информации о CFBundleURLTypes ключ, посмотрите раздел «CFBundleURLTypes» в Инструкциях по Конфигурации Времени выполнения OS X.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

Функции, больше используемые

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

  • LSInit LSInit (OS X v10.3)

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

    Раньше используемый для инициализации Launch Services; больше необходимый.

    Объявление

    Objective C

    OSStatus LSInit ( LSInitializeFlags inFlags );

    Обсуждение

    Вызывание этой функции раньше требовалось для инициализации Launch Services; это больше не необходимо, однако, потому что Launch Services теперь инициализируется автоматически в первый раз, когда одна из его функций вызвана. LSInit теперь не делает ничего вообще.

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

    Objective C

    @import CoreServices;

    Доступность

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

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

  • LSTerm LSTerm (OS X v10.3)

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

    Раньше используемый для завершения Launch Services; теперь ничего не делает.

    Объявление

    Objective C

    OSStatus LSTerm ( void );

    Обсуждение

    Вызывание этой функции раньше требовалось для завершения Launch Services; однако, в этом больше не необходимы и так нельзя вызвать. Это теперь не делает ничего вообще.

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

    Objective C

    @import CoreServices;

    Доступность

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

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

Типы данных

В этом разделе описываются типы данных, определенные в Launch Services API.

  • LSApplicationParameters

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

    Объявление

    Swift

    struct LSApplicationParameters { var version: CFIndex var flags: LSLaunchFlags var application: UnsafePointer<FSRef> var asyncLaunchRefCon: UnsafeMutablePointer<Void> var environment: Unmanaged<CFDictionary>! var argv: Unmanaged<CFArray>! var initialEvent: UnsafeMutablePointer<AppleEvent> }

    Objective C

    struct LSApplicationParameters { CFIndex version; LSLaunchFlags flags; const FSRef * application; void * asyncLaunchRefCon; CFDictionaryRef environment; CFArrayRef argv; AppleEvent * initialEvent }; typedef struct LSApplicationParameters LSApplicationParameters;

    Поля

    version

    Версия структуры. Значение этого поля должно быть 0.

    flags

    Флаги запуска. Для возможных значений посмотрите Флаги Запуска.

    application

    FSRef из приложения для открытия.

    asyncLaunchRefCon

    Клиент refCon это должно появиться в последующих уведомлениях запуска.

    environment

    Словарь CFStringRef ключи и значения для переменных окружения для установки в запущенном процессе. Значение этого поля может быть NULL.

    argv

    Массив значений типа CFStringRef это указывает параметры, которые должны быть переданы main() в запущенном процессе. Значение этого поля может быть NULL. Это поле проигнорировано в OS X v10.4.

    initialEvent

    Первое Событие Apple, которое отправит к запущенному процессу. Значение этого поля может быть NULL.

    Обсуждение

    Эта структура передается в качестве параметра LSOpenApplication, LSOpenItemsWithRole, и LSOpenURLsWithRole.

    Доступность

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

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

  • LSLaunchFSRefSpec

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

    Объявление

    Swift

    struct LSLaunchFSRefSpec { var appRef: UnsafePointer<FSRef> var numDocs: ItemCount var itemRefs: UnsafePointer<FSRef> var passThruParams: UnsafePointer<AEDesc> var launchFlags: LSLaunchFlags var asyncRefCon: UnsafeMutablePointer<Void> }

    Objective C

    struct LSLaunchFSRefSpec { const FSRef *appRef; UInt32 numDocs; const FSRef *itemRefs; const AEDesc *passThruParams; LSLaunchFlags launchFlags; void *asyncRefCon; }; typedef struct LSLaunchFSRefSpec LSLaunchFSRefSpec;

    Поля

    appRef

    Указатель на ссылку файловой системы обозначение приложения запуститься; посмотрите Ссылку Файлового менеджера в Документации управления файлами Углерода для описания FSRef тип данных. Установите это поле в NULL запрашивать что каждый элемент в itemRefs выстройте быть открытыми в его собственном предпочтительном приложении.

    numDocs

    Число элементов в массиве, указанном itemRefs поле. Значение этого поля может быть 0, когда приложение, определяемое appRef запускается, не открывая элементов.

    itemRefs

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

    passThruParams

    Указатель на дескриптор события Apple, передающийся нетронутый как дополнительный параметр с ключевым словом keyAEPropData ('prdt'), в событии Apple, отправленном в каждое приложение, запустился или активировался (ли отдельные предпочтительные приложения или приложение, определяемое appRef). Посмотрите Ссылку менеджера по корпоративным мероприятиям Apple в Документации Межсвязи приложений Углерода для описания AEDesc тип данных. Значение этого поля может быть NULL.

    launchFlags

    Запуск отмечает указание, как запустить каждое приложение (включая то, распечатать ли или просто открыть документы); посмотрите Флаги Запуска для описания этих флагов.

    asyncRefCon

    Указатель на произвольное определенное с помощью приложения значение, переданное в событии Carbon, уведомляющем Вас относительно запуска или завершения приложения (если Вы зарегистрировались для такого уведомления). Значение этого поля может быть NULL.

    Обсуждение

    Этот тип данных определяет основанное на файле обозначение спецификации запуска, ссылкой файловой системы, приложение для запуска, элементы для открытия, или оба. Запрашивать что элементы быть открытым в определенном приложении, наборе appRef, numDocs, и itemRefs соответственно. Запрашивать что каждый определяемый элемент быть открытым в его собственном предпочтительном приложении, наборе appRef к NULL. Запрашивать что определенное приложение быть запущенным, не открывая документов, набора appRef соответственно и набор numDocs к 0.

    Доступность

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

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

  • LSLaunchURLSpec

    Указывает, URL, приложение для запуска, элементы для открытия, или оба, вместе с соответствующей информацией.

    Объявление

    Swift

    struct LSLaunchURLSpec { var appURL: Unmanaged<CFURL>! var itemURLs: Unmanaged<CFArray>! var passThruParams: UnsafePointer<AEDesc> var launchFlags: LSLaunchFlags var asyncRefCon: UnsafeMutablePointer<Void> }

    Objective C

    struct LSLaunchURLSpec { CFURLRef appURL; CFArrayRef itemURLs; const AEDesc *passThruParams; LSLaunchFlags launchFlags; void *asyncRefCon; }; typedef struct LSLaunchURLSpec LSLaunchURLSpec;

    Поля

    appURL

    Базовая Основа ссылка URL обозначение приложения запуститься; посмотрите Ссылку CFURL в Базовой Справочной документации Основы для описания CFURLRef тип данных. URL должен иметь схему file и содержите допустимый путь к файлу приложения или комплекту приложений. Установите это поле в NULL запрашивать что каждый элемент в itemURLs выстройте быть открытыми в его собственном предпочтительном приложении.

    itemURLs

    Ссылка на массив Базовой Основы ссылки URL, определяющие элемент или элементы открыться; посмотрите Ссылку CFArray в Базовой Справочной документации Основы для описания CFArrayRef тип данных. Значение этого поля может быть NULL, когда приложение, определяемое appURL будет запущен, не открывая элементов.

    passThruParams

    Указатель на дескриптор события Apple, передающийся нетронутый как дополнительный параметр с ключевым словом keyAEPropData ('prdt'), в событии Apple, отправленном в каждое приложение, запустился или активировался (ли отдельные предпочтительные приложения или приложение, определяемое appURL). Посмотрите Ссылку менеджера по корпоративным мероприятиям Apple в Документации Межсвязи приложений Углерода для описания AEDesc тип данных. Значение этого поля может быть NULL.

    launchFlags

    Запуск отмечает указание, как запустить каждое приложение (включая то, распечатать ли или просто открыть документы); посмотрите Флаги Запуска для описания этих флагов.

    asyncRefCon

    Указатель на произвольное определенное с помощью приложения значение, переданное в событии Carbon, уведомляющем Вас относительно запуска или завершения приложения (если Вы зарегистрировались для такого уведомления). Значение этого поля может быть NULL.

    Обсуждение

    Этот тип данных определяет ОСНОВАННОЕ НА URL обозначение спецификации запуска, URL, приложение для запуска, элементы для открытия, или оба. Запрашивать что элементы быть открытым в определенном приложении, наборе appURL и itemURLs соответственно. Запрашивать что каждый определяемый элемент быть открытым в его собственном предпочтительном приложении, наборе appURL к NULL. Если схема URL’s элемента file (определяющий или файл или каталог), выбор предпочтительного приложения основывается на расширении файла определяемого элемента, типе файла и подписи создателя; иначе, это основывается на схеме URL (такой как http, ftp, или mailto). Запрашивать что определенное приложение быть запущенным, не открывая документа, набора appURL соответственно и набор itemURLs к NULL.

    Доступность

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

  • LSItemInfoRecord

    Содержит запрошенную информацию об элементе.

    Объявление

    Swift

    struct LSItemInfoRecord { var flags: LSItemInfoFlags var filetype: OSType var creator: OSType var `extension`: Unmanaged<CFString>! }

    Objective C

    struct LSItemInfoRecord { LSItemInfoFlags flags; OSType filetype; OSType creator; CFStringRef extension; CFStringRef iconFileName; LSKindID kindID; }; typedef struct LSItemInfoRecord LSItemInfoRecord;

    Поля

    flags

    Информация элемента отмечает указание информации об элементе; посмотрите Флаги информации элемента для описания этих флагов.

    filetype

    Тип файла элемента.

    creator

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

    extension

    Базовая Основа представляет в виде строки объект, указывающий расширение файла элемента; посмотрите Ссылку CFString в Базовой Справочной документации Основы для описания CFStringRef тип данных.

    iconFileName

    Больше используемый.

    kindID

    Больше используемый.

    Обсуждение

    Этот тип данных определяет информационную запись элемента, используемую LSCopyItemInfoForRef и LSCopyItemInfoForURL функции для возврата запрошенной информации об элементе.

    Доступность

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

  • LSKindID

    Тип данных kindID поле информационной записи элемента (LSItemInfoRecord); больше используемый.

    Объявление

    Objective C

    typedef UInt32 LSKindID;

    Доступность

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

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

Константы

В этом разделе описываются константы, определенные в Launch Services API.

  • Ролевая маска

    Укажите желаемую роль или роли для приложения для требования относительно элемента или семьи элементов.

    Объявление

    Swift

    typealias LSRolesMask = OptionBits

    Objective C

    typedef OptionBits LSRolesMask;enum { kLSRolesNone = 0x00000001, kLSRolesViewer = 0x00000002, kLSRolesEditor = 0x00000004, kLSRolesShell = 0x00000008, kLSRolesAll = 0xFFFFFFFF };

    Константы

    • kLSRolesNone

      kLSRolesNone

      Запрашивает роль None (приложение не может открыть элемент, но обеспечивает значок и добрую строку для него).

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

    • kLSRolesViewer

      kLSRolesViewer

      Запрашивает роль Viewer (приложение может считать и представить элемент, но не может управлять или сохранить его).

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

    • kLSRolesEditor

      kLSRolesEditor

      Запрашивает роль Editor (приложение может считать, представить, управлять и сохранить элемент).

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

    • kLSRolesShell

      kLSRolesShell

      Запрашивает роль Shell (приложение может выполнить элемент).

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

    • kLSRolesAll

      kLSRolesAll

      Принимает любую роль относительно элемента.

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

    Обсуждение

    Эта битовая маска передается функциям, находящим предпочтительное приложение для данного элемента или семьи элементов (LSGetApplicationForItem, LSGetApplicationForURL, LSGetApplicationForInfo), или которые определяют, может ли данное приложение открыть определяемый элемент (LSCanRefAcceptItem, LSCanURLAcceptURL), для указания желаемой роли приложения или ролей относительно элемента. Например, для запроса только приложения редактора указать kLSRolesEditor; если или редактор или приложение средства просмотра приемлемы, указать kLSRolesEditor | kLSRolesViewer.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • Флаги запуска

    Укажите, как запустить приложение.

    Объявление

    Swift

    typealias LSLaunchFlags = OptionBits

    Objective C

    typedef OptionBits LSLaunchFlags;enum { kLSLaunchDefaults = 0x00000001, kLSLaunchAndPrint = 0x00000002, kLSLaunchReserved2 = 0x00000004, kLSLaunchReserved3 = 0x00000008, kLSLaunchReserved4 = 0x00000010, kLSLaunchReserved5 = 0x00000020, kLSLaunchAndDisplayErrors = 0x00000040, kLSLaunchInhibitBGOnly = 0x00000080, kLSLaunchDontAddToRecents = 0x00000100, kLSLaunchDontSwitch = 0x00000200, kLSLaunchNoParams = 0x00000800, kLSLaunchAsync = 0x00010000, kLSLaunchStartClassic = 0x00020000, kLSLaunchInClassic = 0x00040000, kLSLaunchNewInstance = 0x00080000, kLSLaunchAndHide = 0x00100000, kLSLaunchAndHideOthers = 0x00200000, kLSLaunchHasUntrustedContents = 0x00400000 };

    Константы

    • kLSLaunchDefaults

      kLSLaunchDefaults

      Запросы, запускающиеся способом по умолчанию (как будто единственный набор флагов был kLSLaunchNoParams, kLSLaunchAsync, и kLSLaunchStartClassic).

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

    • kLSLaunchAndPrint

      kLSLaunchAndPrint

      Запросы, которые документы открыли в приложении быть распечатанными.

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

    • kLSLaunchReserved2

      kLSLaunchReserved2

      Зарезервированный для будущего использования.

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

    • kLSLaunchReserved3

      kLSLaunchReserved3

      Зарезервированный для будущего использования.

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

    • kLSLaunchReserved4

      kLSLaunchReserved4

      Зарезервированный для будущего использования.

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

    • kLSLaunchReserved5

      kLSLaunchReserved5

      Зарезервированный для будущего использования.

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

    • kLSLaunchAndDisplayErrors

      kLSLaunchAndDisplayErrors

      Запросы, запускающие и открывающие отказы быть выведенными на экран в UI.

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

    • kLSLaunchInhibitBGOnly

      kLSLaunchInhibitBGOnly

      Запросы, что запуск быть сделанным перестать работать, если приложение только для фона.

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

    • kLSLaunchDontAddToRecents

      kLSLaunchDontAddToRecents

      Запросы, что приложение или документы не быть добавленным к меню Finder's Recent Items.

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

    • kLSLaunchDontSwitch

      kLSLaunchDontSwitch

      Запросы, что приложение быть запущенным, не будучи принесенным к переднему плану.

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

    • kLSLaunchNoParams

      kLSLaunchNoParams

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

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

    • kLSLaunchAsync

      kLSLaunchAsync

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

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

    • kLSLaunchStartClassic

      kLSLaunchStartClassic

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

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

    • kLSLaunchInClassic

      kLSLaunchInClassic

      Запросы, что приложение быть вынужденным запуститься в Классической среде эмуляции.

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

    • kLSLaunchNewInstance

      kLSLaunchNewInstance

      Запросы, что новый экземпляр приложения быть запущенным, даже если Вы уже работаете.

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

    • kLSLaunchAndHide

      kLSLaunchAndHide

      Запросы, что приложение быть скрытым, как только это завершает свою последовательность запуска.

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

    • kLSLaunchAndHideOthers

      kLSLaunchAndHideOthers

      Запросы, что другие приложения быть скрытым, как только открытое приложение завершает свою последовательность запуска.

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

    • kLSLaunchHasUntrustedContents

      kLSLaunchHasUntrustedContents

      Запросы, что элементы, которые будут запущены, должны быть отмечены как недоверяемые.

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

    Обсуждение

    Они передаются в структуре спецификации запуска (LSLaunchFSRefSpec к LSOpenFromRefSpec функция или LSLaunchURLSpec к LSOpenFromURLSpec функция), для управления способом, которым запускаются приложения.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • Флаги требуемой информации

    Укажите что информацию получить об элементе.

    Объявление

    Swift

    typealias LSRequestedInfo = OptionBits

    Objective C

    typedef OptionBits LSRequestedInfo;enum { kLSRequestExtension = 0x00000001, kLSRequestTypeCreator = 0x00000002, kLSRequestBasicFlagsOnly = 0x00000004, kLSRequestAppTypeFlags = 0x00000008, kLSRequestAllFlags = 0x00000010, kLSRequestIconAndKind = 0x00000020, kLSRequestExtensionFlagsOnly = 0x00000040, kLSRequestAllInfo = 0xFFFFFFFF };

    Константы

    • kLSRequestExtension

      kLSRequestExtension

      Запрашивает расширение файла элемента.

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

    • kLSRequestTypeCreator

      kLSRequestTypeCreator

      Запрашивает тип файла элемента и подпись создателя.

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

    • kLSRequestBasicFlagsOnly

      kLSRequestBasicFlagsOnly

      Запросы все флаги информации элемента, которые не специализированы: т.е. все кроме kLSItemInfoIsNativeApp через kLSItemInfoAppIsScriptable.

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

    • kLSRequestAppTypeFlags

      kLSRequestAppTypeFlags

      Запросы все специализированные флаги информации элемента: т.е. kLSItemInfoIsNativeApp через kLSItemInfoAppIsScriptable.

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

    • kLSRequestAllFlags

      kLSRequestAllFlags

      Запросы все флаги информации элемента.

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

    • kLSRequestIconAndKind

      kLSRequestIconAndKind

      Не используемый.

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

    • kLSRequestExtensionFlagsOnly

      kLSRequestExtensionFlagsOnly

      Запросы только kLSItemInfoExtensionIsHidden флаг информации элемента.

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

    • kLSRequestAllInfo

      kLSRequestAllInfo

      Запрашивает всю доступную информацию элемента.

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

    Обсуждение

    Эти флаги передаются LSCopyItemInfoForRef и LSCopyItemInfoForURL функции для указания типа информации, которая будет получена в информационной записи элемента; посмотрите LSItemInfoRecord для описания этой структуры.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • Константы атрибута элемента

    Константы раньше получали атрибуты элемента.

    Объявление

    Swift

    let kLSItemContentType: CFString! let kLSItemFileType: CFString! let kLSItemFileCreator: CFString! let kLSItemExtension: CFString! let kLSItemDisplayName: CFString! let kLSItemDisplayKind: CFString! let kLSItemRoleHandlerDisplayName: CFString! let kLSItemIsInvisible: CFString! let kLSItemExtensionIsHidden: CFString!

    Objective C

    const CFStringRef kLSItemContentType; const CFStringRef kLSItemFileType; const CFStringRef kLSItemFileCreator; const CFStringRef kLSItemExtension; const CFStringRef kLSItemDisplayName const CFStringRef kLSItemDisplayKind; const CFStringRef kLSItemRoleHandlerDisplayName; const CFStringRef kLSItemIsInvisible; const CFStringRef kLSItemExtensionIsHidden;

    Константы

    • kLSItemContentType

      kLSItemContentType

      Идентификатор типа контента элемента, который является универсальной строкой идентификатора типа. Тип значения этого атрибута theis CFStringRef.

      Используйте свойство ресурса URL kCFURLTypeIdentifierKey/NSURLTypeIdentifierKey вместо этого.

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

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

    • kLSItemFileType

      kLSItemFileType

      Тип файла элемента (OSType). Тип значения этого атрибута CFStringRef.

      Используйте свойство ресурса URL kCFURLTypeIdentifierKey/NSURLTypeIdentifierKey получить UTI файла вместо этого.

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

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

    • kLSItemFileCreator

      kLSItemFileCreator

      Создатель файла элемента (OSType). Тип значения этого атрибута CFStringRef.

      Используйте свойство ресурса URL kCFURLTypeIdentifierKey/NSURLTypeIdentifierKey получить UTI файла вместо этого.

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

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

    • kLSItemExtension

      kLSItemExtension

      Расширение файла элемента. Тип значения этого атрибута CFStringRef.

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

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

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

    • kLSItemDisplayName

      kLSItemDisplayName

      Имя элемента, как выведено на экран пользователю. Имя дисплея отражает локализацию и расширение, скрывающееся, который может иметь силу. Тип значения этого атрибута CFStringRef.

      Использовать LSCopyDisplayNameForURL или свойство ресурса URL kCFURLLocalizedNameKey/NSURLLocalizedNameKey вместо этого.

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

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

    • kLSItemDisplayKind

      kLSItemDisplayKind

      Локализованная добрая строка, описывающая тип элемента. Тип значения этого атрибута CFStringRef.

      Использовать LSCopyKindStringForURL или свойство ресурса URL kCFURLLocalizedTypeDescriptionKey/NSURLLocalizedTypeDescriptionKey вместо этого.

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

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

    • kLSItemRoleHandlerDisplayName

      kLSItemRoleHandlerDisplayName

      Имя дисплея приложения, установленного обработать этот элемент согласно ролевой маске. Тип значения этого атрибута CFStringRef.

      Вместо того, чтобы использовать эту константу, разрешите желаемый ролевой обработчик для файла, затем используйте свойство ресурса URL kCFURLLocalizedNameKey/NSURLLocalizedNameKey на ролевом обработчике URL.

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

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

    • kLSItemIsInvisible

      kLSItemIsInvisible

      Значение kCFBooleanTrue если элемент обычно скрыт от пользователей; иначе, kCFBooleanFalse. Тип значения этого атрибута CFBooleanRef.

      Используйте свойство ресурса URL kCFURLIsHiddenKey/NSURLIsHiddenKey вместо этого.

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

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

    • kLSItemExtensionIsHidden

      kLSItemExtensionIsHidden

      Значение kCFBooleanTrue если расширение элемента установлено быть скрытым; иначе, kCFBooleanFalse. Тип значения этого атрибута CFBooleanRef.

      Использовать LSSetExtensionHiddenForURL или свойство ресурса URL kCFURLHasHiddenExtensionKey/NSURLHasHiddenExtensionKey вместо этого.

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

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

  • Флаги информации элемента

    Предоставьте информацию об элементе.

    Объявление

    Swift

    typealias LSItemInfoFlags = OptionBits

    Objective C

    typedef OptionBits LSItemInfoFlags;enum { kLSItemInfoIsPlainFile = 0x00000001, kLSItemInfoIsPackage = 0x00000002, kLSItemInfoIsApplication = 0x00000004, kLSItemInfoIsContainer = 0x00000008, kLSItemInfoIsAliasFile = 0x00000010, kLSItemInfoIsSymlink = 0x00000020, kLSItemInfoIsInvisible = 0x00000040, kLSItemInfoIsNativeApp = 0x00000080, kLSItemInfoIsClassicApp = 0x00000100, kLSItemInfoAppPrefersNative = 0x00000200, kLSItemInfoAppPrefersClassic = 0x00000400, kLSItemInfoAppIsScriptable = 0x00000800, kLSItemInfoIsVolume = 0x00001000, kLSItemInfoExtensionIsHidden = 0x00100000 };

    Константы

    • kLSItemInfoIsPlainFile

      kLSItemInfoIsPlainFile

      Элемент является файлом данных (и не, например, каталог, объем или символьная ссылка UNIX).

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

    • kLSItemInfoIsPackage

      kLSItemInfoIsPackage

      Элемент является упакованным каталогом.

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

    • kLSItemInfoIsApplication

      kLSItemInfoIsApplication

      Элемент является однофайловым или пакетным приложением.

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

    • kLSItemInfoIsContainer

      kLSItemInfoIsContainer

      Элемент является каталогом (включает пакеты), или объем.

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

    • kLSItemInfoIsAliasFile

      kLSItemInfoIsAliasFile

      Элемент является файлом псевдонима (включает символьные ссылки).

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

    • kLSItemInfoIsSymlink

      kLSItemInfoIsSymlink

      Элемент является символьной ссылкой UNIX.

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

    • kLSItemInfoIsInvisible

      kLSItemInfoIsInvisible

      Элемент невидим, потому что или его имя начинается с периода или его isInvisible Флаг Finder установлен.

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

    • kLSItemInfoIsNativeApp

      kLSItemInfoIsNativeApp

      Элемент является приложением, которое может работать исходно в OS X.

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

    • kLSItemInfoIsClassicApp

      kLSItemInfoIsClassicApp

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

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

    • kLSItemInfoAppPrefersNative

      kLSItemInfoAppPrefersNative

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

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

    • kLSItemInfoAppPrefersClassic

      kLSItemInfoAppPrefersClassic

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

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

    • kLSItemInfoAppIsScriptable

      kLSItemInfoAppIsScriptable

      Элемент является приложением, которое может быть задано сценарием.

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

    • kLSItemInfoIsVolume

      kLSItemInfoIsVolume

      Элемент является корневым каталогом объема или точки монтирования.

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

    • kLSItemInfoExtensionIsHidden

      kLSItemInfoExtensionIsHidden

      Элемент имеет скрытое расширение файла.

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

    Обсуждение

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

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • Флаги принятия

    Укажите поведение наблюдать при тестировании, может ли приложение принять (открывают) элемент.

    Объявление

    Swift

    typealias LSAcceptanceFlags = OptionBits

    Objective C

    typedef OptionBits LSAcceptanceFlags;enum { kLSAcceptDefault = 0x00000001, kLSAcceptAllowLoginUI = 0x00000002 };

    Константы

    • kLSAcceptDefault

      kLSAcceptDefault

      Запрашивает поведение по умолчанию (в противоположность поведению, указанному kLSAcceptAllowLoginUI флаг).

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

    • kLSAcceptAllowLoginUI

      kLSAcceptAllowLoginUI

      Запросы, что пользовательский интерфейс для входа в систему быть представленным при необходимости. Если LSCanRefAcceptItem или LSCanURLAcceptURL вызывается во время работы перетаскивания, показывая, что диалоговое окно входа в систему сервера было бы несоответствующим пользовательским опытом. Если цель, определяемая в вызове функции, является псевдонимом к приложению, Launch Services должна разрешить псевдоним для установления, какие типы файлов приложение может открыть; однако, если приложение будет на сервере, который должен аутентифицироваться, то Launch Services будет сбоем по умолчанию, чтобы разрешить псевдоним, избежать иметь необходимость представить интерфейс входа в систему. Для переопределения этого поведения по умолчанию путем разрешения интерфейса входа в систему сервера установите kLSAcceptAllowLoginUI флаг.

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

    Обсуждение

    Эти флаги передаются функциям LSCanRefAcceptItem и LSCanURLAcceptURL.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • Константы опции обработчика

    Укажите опции для управления, как выбраны обработчики содержимого.

    Объявление

    Swift

    typealias LSHandlerOptions = OptionBits

    Objective C

    typedef OptionBits LSHandlerOptions;enum { kLSHandlerOptionsDefault = 0, kLSHandlerOptionsIgnoreCreator = 1 };

    Константы

    • kLSHandlerOptionsDefault

      kLSHandlerOptionsDefault

      Когда установлено, Launch Services причин для использования создателя элемента содержания (когда доступный) для выбора обработчика. Это - настройка по умолчанию.

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

    • kLSHandlerOptionsIgnoreCreator

      kLSHandlerOptionsIgnoreCreator

      Когда установлено, Launch Services причин для игнорирования создателя элемента содержания при выборе ролевого обработчика для указанного типа контента.

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

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • Недопустимый дополнительный индекс

    Представляет недопустимый индекс расширения файла.

    Объявление

    Objective C

    enum { kLSInvalidExtensionIndex = 0xFFFFFFFF };

    Константы

    • kLSInvalidExtensionIndex

      kLSInvalidExtensionIndex

      Значение, полученное LSGetExtensionInfo функционируйте, если имя файла не содержит допустимое расширение.

      Доступный в OS X v10.1 через OS X v10.4.

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

  • Неизвестный тип или создатель

    Представляйте неизвестный тип файла или создателя.

    Объявление

    Swift

    var kLSUnknownType: Int { get } var kLSUnknownCreator: Int { get }

    Objective C

    enum { kLSUnknownType = 0, kLSUnknownCreator = 0 };

    Константы

    • kLSUnknownType

      kLSUnknownType

      Значение для предоставления как тип файла (например, к LSGetApplicationForInfo функция), если никакая информация о типе файла не доступна.

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

    • kLSUnknownCreator

      kLSUnknownCreator

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

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

  • Константы, больше используемые

    Следующие константы больше не используются.

    Объявление

    Swift

    typealias LSInitializeFlags = OptionBits

    Objective C

    typedef OptionBits LSInitializeFlags;enum { kLSInitializeDefaults = 0x00000001 };enum { kLSUnknownKindID = 0 };enum { kLSMinCatInfoBitmap = (kFSCatInfoNodeFlags | kFSCatInfoParentDirID | kFSCatInfoFinderInfo | kFSCatInfoFinderXInfo ) };

    Константы

    • kLSInitializeDefaults

      kLSInitializeDefaults

      Раньше переданный LSInit больше не использующаяся функция.

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

    • kLSUnknownKindID

      kLSUnknownKindID

      Возможное значение kindID поле больше не использующейся информационной записи элемента.

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

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

    • kLSMinCatInfoBitmap

      kLSMinCatInfoBitmap

      Минимальный битовый массив информации о каталоге; больше используемый.

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

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

Таблица ниже приводит наиболее распространенные коды результата, возвращенные функциями Launch Services.

  • kLSAppInTrashErr

    Приложение не может быть запущено, потому что это в Папке «Удаленные».

    Значение

    - 10660

    Описание

    Приложение не может быть запущено, потому что это в Папке «Удаленные».

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

  • kLSUnknownErr

    Произошла неизвестная ошибка.

    Значение

    - 10810

    Описание

    Произошла неизвестная ошибка.

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

  • kLSNotAnApplicationErr

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

    Значение

    - 10811

    Описание

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

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

  • kLSNotInitializedErr

    Раньше возвращенный LSInit на отказе в инициализации; больше используемый.

    Значение

    - 10812

    Описание

    Раньше возвращенный LSInit на отказе в инициализации; больше используемый.

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

  • kLSDataUnavailableErr

    Данные желаемого типа не доступны (например, нет никакой доброй строки).

    Значение

    - 10813

    Описание

    Данные желаемого типа не доступны (например, нет никакой доброй строки).

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

  • kLSApplicationNotFoundErr

    Никакое приложение в базе данных Launch Services не соответствует входные критерии.

    Значение

    - 10814

    Описание

    Никакое приложение в базе данных Launch Services не соответствует входные критерии.

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

  • kLSUnknownTypeErr

    Не в настоящее время используемый.

    Значение

    - 10815

    Описание

    Не в настоящее время используемый.

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

  • kLSDataTooOldErr

    Не в настоящее время используемый.

    Значение

    - 10816

    Описание

    Не в настоящее время используемый.

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

  • kLSDataErr

    Данные структурированы неправильно (например, информационный список свойств элемента уродлив). Не используемый в OS X v10.4.

    Значение

    - 10817

    Описание

    Данные структурированы неправильно (например, информационный список свойств элемента уродлив). Не используемый в OS X v10.4.

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

  • kLSLaunchInProgressErr

    Запуск приложения уже происходит.

    Значение

    - 10818

    Описание

    Запуск приложения уже происходит.

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

  • kLSNotRegisteredErr

    Не в настоящее время используемый.

    Значение

    - 10819

    Описание

    Не в настоящее время используемый.

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

  • kLSAppDoesNotClaimTypeErr

    Не в настоящее время используемый.

    Значение

    - 10820

    Описание

    Не в настоящее время используемый.

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

  • kLSAppDoesNotSupportSchemeWarning

    Не в настоящее время используемый.

    Значение

    - 10821

    Описание

    Не в настоящее время используемый.

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

  • kLSServerCommunicationErr

    Существует проблема, связывающаяся с серверным процессом, поддерживающим базу данных Launch Services.

    Значение

    - 10822

    Описание

    Существует проблема, связывающаяся с серверным процессом, поддерживающим базу данных Launch Services.

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

  • kLSCannotSetInfoErr

    Расширение файла, которое будет скрыто, не может быть скрыто.

    Значение

    - 10823

    Описание

    Расширение файла, которое будет скрыто, не может быть скрыто.

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

  • kLSNoRegistrationInfoErr

    Не в настоящее время используемый.

    Значение

    - 10824

    Описание

    Не в настоящее время используемый.

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

  • kLSIncompatibleSystemVersionErr

    Приложение, которое будет запущено, не может работать на текущей версии Mac OS.

    Значение

    - 10825

    Описание

    Приложение, которое будет запущено, не может работать на текущей версии Mac OS.

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

  • kLSNoLaunchPermissionErr

    У пользователя нет разрешения запустить приложение (в управляемой сети).

    Значение

    - 10826

    Описание

    У пользователя нет разрешения запустить приложение (в управляемой сети).

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

  • kLSNoExecutableErr

    Исполняемый файл пропускает или имеет неприменимый формат.

    Значение

    - 10827

    Описание

    Исполняемый файл пропускает или имеет неприменимый формат.

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

  • kLSNoClassicEnvironmentErr

    Классическая среда эмуляции требовалась, но не доступна.

    Значение

    - 10828

    Описание

    Классическая среда эмуляции требовалась, но не доступна.

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

  • kLSMultipleSessionsNotSupportedErr

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

    Значение

    - 10829

    Описание

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

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