Ссылка файлового менеджера

Файловый менеджер был базовой службой в OS X, управлявшем организацией, чтением и записью данных, расположенных на физических устройствах хранения данных, таких как дисководы. Файловый менеджер был разработан для обеспечения уровня абстракции, скрывающего подробные данные реализации низшего уровня, такие как различные файловые системы и форматы объема. Для устаревших приложений, которые должны были иметь то же представление файловой системы, замеченной в пользовательском интерфейсе OS X, Файловый менеджер был надлежащим инструментом. Например, Файловый менеджер часто использовался в средах разработки приложения, таких как Углерод и Какао для реализации связанных с файлом операций.

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

Функции

Доступ к информации о файлах и каталогах


    
    FSGetCatalogInfo
    FSGetCatalogInfo

(OS X v10.8)

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

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

Объявление

Objective C

OSErr FSGetCatalogInfo ( const FSRef *ref, FSCatalogInfoBitmap whichInfo, FSCatalogInfo *catalogInfo, HFSUniStr255 *outName, FSSpecPtr fsSpec, FSRef *parentRef );

Параметры

`ref`	Указатель на `FSRef` указание файла или каталога, для которого можно получить информацию. Посмотрите `FSRef` для описания `FSRef` тип данных.
`whichInfo`	Битовый массив, указывающий поля информации о каталоге для возврата. Если Вы не хотите информации о каталоге, установить `whichInfo` к константе `kFSCatInfoNone`. Посмотрите Растровые Константы информации о Каталоге для описания битов в этом параметре.
`catalogInfo`	По возврату, указателю на информационную структуру каталога, содержащую информацию о файле или каталоге. Только информация, указанная в `whichInfo` параметр возвращается. Если Вы не хотите информации о каталоге, передачи `NULL` здесь. Посмотрите `FSCatalogInfo` для описания `FSCatalogInfo` тип данных.
`outName`	По возврату указатель на имя Unicode файла или каталога возвращается сюда. Этот параметр является дополнительным; если Вам не жаль, что имя не возвратилось, передача `NULL` здесь. Посмотрите `HFSUniStr255` для описания `HFSUniStr255` тип данных.
`fsSpec`	По возврату, указателю на `FSSpec` для файла или каталога. Этот параметр является дополнительным; если Вы не желаете `FSSpec` возвращенный, передача `NULL` здесь. Посмотрите `FSSpec` для описания `FSSpec` тип данных.
`parentRef`	По возврату, указателю на `FSRef` для родительского каталога объекта. Этот параметр является дополнительным; если Вам не жаль, что родительский каталог не возвратился, передача `NULL` здесь. Если объект, указанный в `ref` параметр является корневым каталогом объема, тогда `FSRef` возвращенный здесь не будет допустимое `FSRef`, так как корневой каталог не имеет никакого родительского объекта.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

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

Objective C

@import CoreServices;

Доступность

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

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


    
    PBGetCatInfoSync
    PBGetCatInfoSync

(OS X v10.4)

Информация о каталоге возвратов о файле или каталоге.

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

Объявление

Objective C

OSErr PBGetCatInfoSync ( CInfoPBPtr paramBlock );

Параметры


      paramBlock

Указатель на блок параметра информации о каталоге HFS. Посмотрите CInfoPBRec для описания CInfoPBRec тип данных.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

PBGetCatInfoSync функционируйте информация о возвратах о файле или каталоге, в зависимости от значений, которые Вы указываете в ioFDirIndex, ioNamePtr, ioVRefNum, и ioDirID или ioDrDirID поля. Если необходимо определить, возвратилась ли информация, для файла или каталога, можно протестировать бит 4 из ioFlAttrib поле; если тот бит установлен, информация возвратилась, описывает каталог.

PBGetCatInfoSync функция выбирает файл или каталог согласно этим правилам:

Если значение ioFDirIndex положительно, ioNamePtr не используется в качестве входного параметра и PBGetCatInfoSync информация о возвратах о файле или каталоге, индекс каталога которого ioFDirIndex в каталоге, указанном ioDirID (или ioDrDirID) на объеме, указанном ioVRefNum (это будет корневым каталогом если ioVRefNum ссылочный номер объема или число диска и ioDirID 0). Если ioNamePtr не NULL, тогда это должно указать на a Str31 буферизуйте, куда будет возвращено имя файла или каталога.
Если значение ioFDirIndex 0, PBGetCatInfoSync информация о возвратах о файле или каталоге, указанном ioNamePtr в каталоге, указанном ioDirID (или ioDrDirID) на объеме, указанном ioVRefNum (снова, это будет корневым каталогом если ioVRefNum ссылочный номер объема или число диска, и ioDirID 0).
Если значение ioFDirIndex отрицательно, PBGetCatInfoSync игнорирует ioNamePtr поле и информация о возвратах о каталоге, указанном в ioDrDirID поле. Если ioNamePtr не NULL, тогда это должно указать на a Str31 буферизуйте, куда будет возвращено имя каталога.

С файлами, PBGetCatInfoSync подобно PBHGetFInfoSync но возвраты некоторая дополнительная информация. Если объект является файлом, соответствующие поля блока параметра:

`ioNamePtr`	На вводе, указателе на путь. Если файл открыт, на выводе имя файла возвращается в этом поле. Если Вы не хотите имя возвращенного файла, передача `NULL` в этом поле.
`ioVRefNum`	На вводе, ссылочном номере объема, числе диска, или 0 для объема по умолчанию.
`ioFRefNum`	На выводе, числе ссылки на файл. Если файл открыт, ссылочный номер первого найденного пути доступа возвращается сюда.
`ioFDirIndex`	На вводе, индексе каталога.
`ioFlAttrib`	На выводе, атрибутах файла. Посмотрите Константы Атрибута файла для значения атрибутов файла.
`ioFlFndrInfo`	На выводе информация используется Средством поиска.
`ioDirID`	На вводе, каталоге ID. На выводе, идентификаторе файла. Вы, возможно, должны были бы сохранить значение `ioDirID` перед вызовом `PBGetCatInfoSync` если Вы выполняете последующие вызовы с тем же блоком параметра.
`ioFlStBlk`	На выводе, первом блоке выделения ветви данных.
`ioFlLgLen`	На выводе, логический размер (логический конец файла) ветви данных, в байтах.
`ioFlPyLen`	На выводе, физический размер (физический конец файла) ветви данных, в байтах.
`ioFlRStBlk`	На выводе, первом блоке выделения ветви ресурсов.
`ioFlRLgLen`	На выводе, логическом размере ветви ресурсов, в байтах.
`ioFlRPyLen`	На выводе, физическом размере ветви ресурсов, в байтах.
`ioFlCrDat`	На выводе, дате и времени создания файла. Обратите внимание на то, что файловые системы кроме AFP, HFS и HFS Плюс обычно не поддерживают даты создания. Для файловых систем, не поддерживающих даты создания, Файловый менеджер устанавливает `ioFlCrDat` поле к 0.
`ioFlMdDat`	На выводе, дате и времени последнего изменения файла.
`ioFlBkDat`	На выводе, дате и времени последнего резервного копирования файла. Обратите внимание на то, что файловые системы кроме AFP, HFS и HFS Плюс обычно не поддерживают резервные даты. Для файловых систем, не поддерживающих резервные даты, Файловый менеджер устанавливает `ioFlBkDat` поле к 0.
`ioFlXFndrInfo`	На выводе дополнительная информация используется Средством поиска.
`ioFlParID`	На выводе, каталоге ID родительского каталога файла.
`ioFlClpSiz`	На выводе, размере глыбы файла.

Можно также использовать PBGetCatInfoSync определить, имеет ли файл ссылку идентификатора файла. Значение идентификатора файла возвращается в ioDirID поле. Поскольку тот параметр мог также представлять каталог ID, вызвать PBResolveFileIDRefSync видеть, является ли значение реальным идентификатором файла. Если Вы хотите определить, существует ли ссылка идентификатора файла для файла, и создайте тот, если это не делает, использовать PBCreateFileIDRefSync , который или создаст идентификатор файла или возврат fidExists.

Если объект является каталогом, соответствующие поля блока параметра:

`ioNamePtr`	На вводе, указателе на путь. На выводе, указателе на имя каталога.
`ioVRefNum`	На вводе, ссылочном номере объема, числе диска, или 0 для объема по умолчанию.
`ioFDirIndex`	На вводе, индексе каталога.
`ioFlAttrib`	На выводе, атрибутах каталога. Посмотрите Константы Атрибута файла для значения битов в этом поле. Биты в этом поле для каталогов только для чтения. Вы не можете изменить атрибуты каталога путем установки этих битов с помощью функций `PBSetCatInfoSync` или `PBSetCatInfoAsync`. Вместо этого можно вызвать `PBHSetFLockSync` и `PBHRstFLockSync` функции, чтобы заблокировать и разблокировать каталог, и `PBShareSync` и `PBUnshareSync` функции, чтобы включить и отключить совместный доступ к файлам на локальных каталогах.
`ioACUser`	На выводе, правах доступа каталога. `PBGetCatInfoSync` функционируйте возвращает информацию в этом поле только для совместно используемых томов. В результате необходимо установить это поле в 0 перед вызовом `PBGetCatInfoSync`. `PBGetCatInfoSync` не возвращается пустые права доступа укусили в этом поле; чтобы определить, имеет ли каталог пустые права доступа, используйте `PBHGetDirAccessSync` функция. Посмотрите Константы Полномочий пользователя для описания констант, которые могут быть возвращены сюда.
`ioDrUsrWds`	На выводе информация используется Средством поиска.
`ioDrDirID`	На вводе, если Вы хотите получить информацию об определенном каталоге, что ID каталога. Иначе, если объект возвратился, каталог, это поле содержит каталог ID на выводе.
`ioDrNmFls`	На выводе, числе файлов в каталоге.
`ioDrCrDat`	На выводе, дате и времени создания каталога. Обратите внимание на то, что файловые системы кроме AFP, HFS и HFS Плюс обычно не поддерживают даты создания. Для файловых систем, не поддерживающих даты создания, Файловый менеджер устанавливает `ioDrCrDat` поле к 0.
`ioDrMdDat`	На выводе, дате и времени последнего изменения каталога.
`ioDrBkDat`	На выводе, дате и времени последнего резервного копирования каталога. Обратите внимание на то, что файловые системы кроме AFP, HFS и HFS Плюс обычно не поддерживают резервные даты. Для файловых систем, не поддерживающих резервные даты, Файловый менеджер устанавливает `ioDrBkDat` поле к 0.
`ioDrFndrInfo`	На выводе дополнительная информация используется Средством поиска.
`ioDrParID`	На выводе, каталоге ID родительского каталога каталога.

Получить информацию о файле или каталоге с именованными ветвлениями, или на файле, больше, чем 2 ГБ, использовании одном из FSGetCatalogInfo , PBGetCatalogInfoSync , или PBGetCatalogInfoAsync функции.

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

Objective C

@import CoreServices;

Доступность

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

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

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


    
    PBGetCatalogInfoSync
    PBGetCatalogInfoSync

(OS X v10.8)

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

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

Объявление

Objective C

OSErr PBGetCatalogInfoSync ( FSRefParam *paramBlock );

Параметры


      paramBlock

Указатель на блок параметра ссылки файловой системы. Посмотрите FSRefParam для описания FSRefParam тип данных.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ref`	На вводе, указателе на `FSRef` указание файла или каталога, для которого можно получить информацию.
`whichInfo`	На вводе, битовый массив, указывающий поля информации о каталоге для возврата. Если Вы не хотите информации о каталоге, установить `whichInfo` к константе `kFSCatInfoNone`. Посмотрите Растровые Константы информации о Каталоге для описания битов в этом поле.
`catInfo`	На выводе, указателе на `FSCatalogInfo` структура, содержащая информацию о файле или каталоге. Только информация, указанная в `whichInfo` поле возвращается. Если Вы не хотите информации о каталоге, передачи `NULL` здесь.
`spec`	На выводе, указателе на `FSSpec` для файла или каталога. Этот вывод является дополнительным; если Вы не желаете `FSSpec` возвращенный, передача `NULL` здесь.
`parentRef`	На выводе, указателе на `FSRef` для родительского каталога объекта. Этот вывод является дополнительным; если Вам не жаль, что родительский каталог не возвратился, передача `NULL` здесь. Если объект, указанный в `ref` поле является корневым каталогом объема, тогда `FSRef` возвращенный в этом поле не будет допустимое `FSRef`, так как корневой каталог не имеет никакого родительского объекта.
`outName`	На выводе, указателе на имя Unicode файла или каталога. На вводе передайте указатель на `HFSUniStr255` структура, если Вы желаете имени, возвратилась; иначе, передача `NULL`.

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

Objective C

@import CoreServices;

Доступность

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

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


    
    PBGetCatInfoAsync
    PBGetCatInfoAsync

(OS X v10.4)

Информация о каталоге возвратов о файле или каталоге.

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

Объявление

Objective C

OSErr PBGetCatInfoAsync ( CInfoPBPtr paramBlock );

Параметры


      paramBlock

Указатель на блок параметра информации о каталоге HFS. Посмотрите CInfoPBRec для описания CInfoPBRec тип данных.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

PBGetCatInfoAsync функционируйте информация о возвратах о файле или каталоге, в зависимости от значений, которые Вы указываете в ioFDirIndex, ioNamePtr, ioVRefNum, и ioDirID или ioDrDirID поля. Если необходимо определить, возвратилась ли информация, для файла или каталога, можно протестировать бит 4 из ioFlAttrib поле; если тот бит установлен, информация возвратилась, описывает каталог.

PBGetCatInfoAsync функция выбирает файл или каталог согласно этим правилам:

Если значение ioFDirIndex положительно, ioNamePtr не используется в качестве входного параметра и PBGetCatInfoAsync информация о возвратах о файле или каталоге, индекс каталога которого ioFDirIndex в каталоге, указанном ioDirID (или ioDrDirID) на объеме, указанном ioVRefNum (это будет корневым каталогом если ioVRefNum ссылочный номер объема или число диска и ioDirID 0). Если ioNamePtr не NULL, тогда это должно указать на a Str31 буферизуйте, куда будет возвращено имя файла или каталога.
Если значение ioFDirIndex 0, PBGetCatInfoAsync информация о возвратах о файле или каталоге, указанном ioNamePtr в каталоге, указанном ioDirID (или ioDrDirID) на объеме, указанном ioVRefNum (снова, это будет корневым каталогом если ioVRefNum ссылочный номер объема или число диска и ioDirID 0).
Если значение ioFDirIndex отрицательно, PBGetCatInfoAsync игнорирует ioNamePtr поле и информация о возвратах о каталоге, указанном в ioDrDirID поле. Если ioNamePtr не NULL, тогда это должно указать на a Str31 буферизуйте, куда будет возвращено имя каталога.

С файлами, PBGetCatInfoAsync подобно PBHGetFInfoAsync но возвраты некоторая дополнительная информация. Если объект является файлом, соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на функцию завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции.
`ioNamePtr`	На вводе, указателе на путь. Если файл открыт, на выводе имя файла возвращается в этом поле. Если Вы не хотите имя возвращенного файла, передача `NULL` в этом поле.
`ioVRefNum`	На вводе, ссылочном номере объема, числе диска, или 0 для объема по умолчанию.
`ioFRefNum`	На выводе, числе ссылки на файл. Если файл открыт, ссылочный номер первого найденного пути доступа возвращается сюда .
`ioFDirIndex`	На вводе, индексе каталога.
`ioFlAttrib`	На выводе, атрибутах файла. Посмотрите Константы Атрибута файла для значения атрибутов файла.
`ioFlFndrInfo`	На выводе информация используется Средством поиска.
`ioDirID`	На вводе, каталоге ID. На выводе, идентификаторе файла. Вы, возможно, должны были бы сохранить значение `ioDirID` перед вызовом `PBGetCatInfoAsync` если Вы выполняете последующие вызовы с тем же блоком параметра.
`ioFlStBlk`	На выводе, первом блоке выделения ветви данных.
`ioFlLgLen`	На выводе, логический размер (логический конец файла) ветви данных, в байтах.
`ioFlPyLen`	На выводе, физический размер (физический конец файла) ветви данных, в байтах.
`ioFlRStBlk`	На выводе, первом блоке выделения ветви ресурсов.
`ioFlRLgLen`	На выводе, логическом размере ветви ресурсов, в байтах.
`ioFlRPyLen`	На выводе, физическом размере ветви ресурсов, в байтах.
`ioFlCrDat`	На выводе, дате и времени создания файла. Обратите внимание на то, что файловые системы кроме AFP, HFS и HFS Плюс обычно не поддерживают даты создания. Для файловых систем, не поддерживающих даты создания, Файловый менеджер устанавливает `ioFlCrDat` поле к 0.
`ioFlMdDat`	На выводе, дате и времени последнего изменения файла.
`ioFlBkDat`	На выводе, дате и времени последнего резервного копирования файла. Обратите внимание на то, что файловые системы кроме AFP, HFS и HFS Плюс обычно не поддерживают резервные даты. Для файловых систем, не поддерживающих резервные даты, Файловый менеджер устанавливает `ioFlBkDat` поле к 0.
`ioFlXFndrInfo`	На выводе дополнительная информация используется Средством поиска.
`ioFlParID`	На выводе, каталоге ID родительского каталога файла.
`ioFlClpSiz`	На выводе, размере глыбы файла.

Можно также использовать PBGetCatInfoAsync определить, имеет ли файл ссылку идентификатора файла. Значение идентификатора файла возвращается в ioDirID поле. Поскольку тот параметр мог также представлять каталог ID, вызвать PBResolveFileIDRefAsync видеть, является ли значение реальным идентификатором файла. Если Вы хотите определить, существует ли ссылка идентификатора файла для файла, и создайте тот, если это не делает, использовать PBCreateFileIDRefAsync , который или создаст идентификатор файла или возврат fidExists.

Если объект является каталогом, соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на функцию завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции.
`ioNamePtr`	На вводе, указателе на путь. На выводе, указателе на имя каталога.
`ioVRefNum`	На вводе, ссылочном номере объема, числе диска, или 0 для объема по умолчанию.
`ioFDirIndex`	На вводе, индексе каталога.
`ioFlAttrib`	На выводе, атрибутах каталога. Посмотрите Константы Атрибута файла для значения битов в этом поле. Биты в этом поле для каталогов только для чтения. Вы не можете изменить атрибуты каталога путем установки этих битов с помощью функций `PBSetCatInfoSync` или `PBSetCatInfoAsync`. Вместо этого можно вызвать `PBHSetFLockSync` и `PBHRstFLockSync` функции, чтобы заблокировать и разблокировать каталог, и `PBShareSync` и `PBUnshareSync` функции, чтобы включить и отключить совместный доступ к файлам на локальных каталогах.
`ioACUser`	На выводе, правах доступа каталога. `PBGetCatInfoAsync` функционируйте возвращает информацию в этом поле только для совместно используемых томов. В результате необходимо установить это поле в 0 перед вызовом `PBGetCatInfoAsync`.`PBGetCatInfoAsync` не возвращается пустые права доступа укусили в этом поле; чтобы определить, имеет ли каталог пустые права доступа, используйте `PBHGetDirAccessAsync` функция. Посмотрите Константы Полномочий пользователя для описания констант, которые могут быть возвращены в этом поле.
`ioDrUsrWds`	На выводе информация используется Средством поиска.
`ioDrDirID`	На вводе, если Вы хотите получить информацию об определенном каталоге, что ID каталога. Иначе, если объект возвратился, каталог, это поле содержит каталог ID на выводе.
`ioDrNmFls`	На выводе, числе файлов в каталоге.
`ioDrCrDat`	На выводе, дате и времени создания каталога. Обратите внимание на то, что файловые системы кроме AFP, HFS и HFS Плюс обычно не поддерживают даты создания. Для файловых систем, не поддерживающих даты создания, Файловый менеджер устанавливает `ioDrCrDat` поле к 0.
`ioDrMdDat`	На выводе, дате и времени последнего изменения каталога.
`ioDrBkDat`	На выводе, дате и времени последнего резервного копирования каталога. Обратите внимание на то, что файловые системы кроме AFP, HFS и HFS Плюс обычно не поддерживают резервные даты. Для файловых систем, не поддерживающих резервные даты, Файловый менеджер устанавливает `ioDrBkDat` поле к 0.
`ioDrFndrInfo`	На выводе дополнительная информация используется Средством поиска.
`ioDrParID`	На выводе, каталоге ID родительского каталога каталога.

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

Objective C

@import CoreServices;

Доступность

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

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

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


    
    PBGetCatalogInfoAsync
    PBGetCatalogInfoAsync

(OS X v10.8)

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

Объявление

Objective C

void PBGetCatalogInfoAsync ( FSRefParam *paramBlock );

Параметры


      paramBlock

Указатель на блок параметра ссылки файловой системы. Посмотрите FSRefParam fro s описание FSRefParam тип данных.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции.
`ref`	На вводе, указателе на `FSRef` указание файла или каталога, для которого можно получить информацию.
`whichInfo`	На вводе, битовый массив, указывающий поля информации о каталоге для возврата. Если Вы не хотите информации о каталоге, установить `whichInfo` к константе `kFSCatInfoNone`. Посмотрите Растровые Константы информации о Каталоге для описания битов в этом поле.
`catInfo`	На выводе, указателе на `FSCatalogInfo` структура, содержащая информацию о файле или каталоге. Только информация, указанная в `whichInfo` поле возвращается. Если Вы не хотите информации о каталоге, передачи `NULL` здесь.
`spec`	На выводе, указателе на `FSSpec` для файла или каталога. Этот вывод является дополнительным; если Вы не желаете `FSSpec` возвращенный, передача `NULL` здесь.
`parentRef`	На выводе, указателе на `FSRef` для родительского каталога объекта. Этот вывод является дополнительным; если Вам не жаль, что родительский каталог не возвратился, передача `NULL` здесь. Если объект, указанный в `ref` поле является корневым каталогом объема, тогда `FSRef` возвращенный в этом поле не будет допустимое `FSRef`, так как корневой каталог не имеет никакого родительского объекта.
`outName`	На выводе, указателе на имя Unicode файла или каталога. На вводе передайте указатель на `HFSUniStr255` структура, если Вы желаете имени, возвратилась; иначе, передача `NULL`.

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

Objective C

@import CoreServices;

Доступность

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

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


    
    PBSetCatInfoSync
    PBSetCatInfoSync

(OS X v10.4)

Изменяет информацию о каталоге для файла или каталога.

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

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

Объявление

Objective C

OSErr PBSetCatInfoSync ( CInfoPBPtr paramBlock );

Параметры


      paramBlock

Указатель на блок параметра информации о каталоге HFS. Посмотрите CInfoPBRec для описания CInfoPBRec тип данных.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

PBSetCatInfoSync функционируйте информация о наборах о файле или каталоге. Когда используется установить информацию о файле, это работает очень как PBHSetFInfoSync делает, но позволяет Вам установить некоторую дополнительную информацию.

Если объект является файлом, соответствующие поля блока параметра:

`ioNamePtr`	На вводе, указателе на путь.
`ioVRefNum`	На вводе, ссылочном номере объема, числе диска, или 0 для объема по умолчанию.
`ioFlFndrInfo`	На вводе, информации о Средстве поиска для файла.
`ioDirID`	На вводе, родительский каталог ID файла.
`ioFlCrDat`	На вводе, дате и времени создания файла.
`ioFlMdDat`	На вводе, дате и времени последнего изменения файла.
`ioFlBkDat`	На вводе, дате и времени последнего резервного копирования файла.
`ioFlXFndrInfo`	На вводе, расширенной информации о Средстве поиска.

Если объект является каталогом, соответствующие поля блока параметра:

`ioNamePtr`	На вводе, указателе на путь.
`ioVRefNum`	На вводе, ссылочном номере объема, числе диска, или 0 для объема по умолчанию.
`ioDrUsrWds`	На вводе информация используется Средством поиска.
`ioDrDirID`	На вводе, каталоге ID.
`ioDrCrDat`	На вводе, дате и времени создания каталога.
`ioDrMdDat`	На вводе, дате и времени последнего изменения каталога.
`ioDrBkDat`	На вводе, дате и времени последнего резервного копирования каталога.
`ioDrFndrInfo`	На вводе дополнительная информация используется Средством поиска.

Изменить информацию о каталоге для именованного ветвления кроме ветви данных и ветви ресурсов, или изменить другую информацию о каталоге поддержали на HFS Плюс объемы, который не является модифицируемым через PBSetCatInfoSync, используйте одну из функций, FSSetCatalogInfo , PBSetCatalogInfoSync , или PBSetCatalogInfoAsync.

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

Objective C

@import CoreServices;

Доступность

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

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

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


    
    FSSetCatalogInfo
    FSSetCatalogInfo

(OS X v10.8)

Информация о каталоге наборов о файле или каталоге.

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

На уровне Foundation использовать setResourceValue:forKey:error: или setResourceValues:error: вместо этого. На уровне Core Foundation использовать CFURLSetResourcePropertyForKey или CFURLSetResourcePropertiesForKeys вместо этого.

Объявление

Objective C

OSErr FSSetCatalogInfo ( const FSRef *ref, FSCatalogInfoBitmap whichInfo, const FSCatalogInfo *catalogInfo );

Параметры

`ref`	Указатель на `FSRef` указание файла или каталога, информация которого должна быть изменена. Посмотрите `FSRef` для описания `FSRef` тип данных.
`whichInfo`	Битовый массив, указывающий, который поля информации о каталоге установить. Только некоторые поля информации о каталоге могут быть установлены. Эти поля даны константой `kFSCatInfoSettableInfo`; никакие другие биты не могут быть установлены в `whichInfo` параметр. Посмотрите Растровые Константы информации о Каталоге для описания битов в этом параметре. Для установки идентификатора пользователя (UID) и группа ID (GID) укажите `kFSCatInfoSetOwnership` флаг в этом параметре. Файловый менеджер пытается установить пользователя и группу ID к значениям, указанным в `permissions` поле информационной структуры каталога. Если `FSSetCatalogInfo` не может установить пользователя и группу IDs, она возвращает ошибку.
`catalogInfo`	Указатель на структуру, содержащую новую информацию о каталоге. Только некоторые поля информации о каталоге могут быть установлены. Поля, которые могут быть установлены: `createDate` `contentModDate` `attributeModDate` `accessDate` `backupDate` `permissions` `finderInfo` `extFinderInfo` `textEncodingHint`

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

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

Objective C

@import CoreServices;

Доступность

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

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


    
    PBSetCatInfoAsync
    PBSetCatInfoAsync

(OS X v10.4)

Изменяет информацию о каталоге для файла или каталога.

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

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

Объявление

Objective C

OSErr PBSetCatInfoAsync ( CInfoPBPtr paramBlock );

Параметры


      paramBlock

Указатель на блок параметра информации о каталоге HFS. Посмотрите CInfoPBRec для описания CInfoPBRec тип данных.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

PBSetCatInfoAsync функционируйте информация о наборах о файле или каталоге. Когда используется установить информацию о файле, это работает очень как PBHSetFInfoAsync делает, но позволяет Вам установить некоторую дополнительную информацию.

Если объект является файлом, соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на функцию завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции.
`ioNamePtr`	На вводе, указателе на путь.
`ioVRefNum`	На вводе, ссылочном номере объема, числе диска, или 0 для объема по умолчанию.
`ioFlFndrInfo`	На вводе, информации о Средстве поиска для файла.
`ioDirID`	На вводе, родительский каталог ID файла.
`ioFlCrDat`	На вводе, дате и времени создания файла.
`ioFlMdDat`	На вводе, дате и времени последнего изменения файла.
`ioFlBkDat`	На вводе, дате и времени последнего резервного копирования файла.
`ioFlXFndrInfo`	На вводе, расширенной информации о Средстве поиска.

Если объект является каталогом, соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на функцию завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции.
`ioNamePtr`	На вводе, указателе на путь.
`ioVRefNum`	На вводе, ссылочном номере объема, числе диска, или 0 для объема по умолчанию.
`ioDrUsrWds`	На вводе информация используется Средством поиска.
`ioDrDirID`	На вводе, каталоге ID.
`ioDrCrDat`	На вводе, дате и времени создания каталога.
`ioDrMdDat`	На вводе, дате и времени последнего изменения каталога.
`ioDrBkDat`	На вводе, дате и времени последнего резервного копирования каталога.
`ioDrFndrInfo`	На вводе дополнительная информация используется Средством поиска.

Изменить информацию о каталоге для именованного ветвления кроме ветви данных и ветви ресурсов, или изменить другую информацию о каталоге поддержали на HFS Плюс объемы, который не является модифицируемым через PBSetCatInfoAsync, используйте одну из функций, FSSetCatalogInfo , PBSetCatalogInfoSync , или PBSetCatalogInfoAsync.

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

Objective C

@import CoreServices;

Доступность

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

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

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


    
    PBSetCatalogInfoSync
    PBSetCatalogInfoSync

(OS X v10.8)

Устанавливает информацию о каталоге о файле или каталоге.

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

Объявление

Objective C

OSErr PBSetCatalogInfoSync ( FSRefParam *paramBlock );

Параметры


      paramBlock

Указатель на блок параметра ссылки файловой системы. Посмотрите FSRefParam fro s описание FSRefParam тип данных.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ref`	На вводе, указателе на `FSRef` указание файла или каталога, информация которого должна быть изменена.
`whichInfo`	На вводе, битовый массив, указывающий, который поля информации о каталоге установить. Только некоторые поля информации о каталоге могут быть установлены. Эти поля даны константой `kFSCatInfoSettableInfo`; никакие другие биты не могут быть установлены в `whichInfo` поле. Посмотрите Растровые Константы информации о Каталоге для описания битов в этом поле. Для установки идентификатора пользователя (UID) и группа ID (GID) укажите `kFSCatInfoSetOwnership` флаг в этом поле. Файловый менеджер пытается установить пользователя и группу ID к значениям, указанным в `permissions` поле информационной структуры каталога. Если `PBSetCatalogInfoSync` не может установить пользователя и группу IDs, она возвращает ошибку.
`catInfo`	На вводе, указателе на `FSCatalogInfo` структура, содержащая новую информацию о каталоге. Только некоторые поля информации о каталоге могут быть установлены. Поля, которые могут быть установлены: `createDate` `contentModDate` `attributeModDate` `accessDate` `backupDate` `permissions` `finderInfo` `extFinderInfo` `textEncodingHint`

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

Objective C

@import CoreServices;

Доступность

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

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


    
    PBSetCatalogInfoAsync
    PBSetCatalogInfoAsync

(OS X v10.8)

Устанавливает информацию о каталоге о файле или каталоге.

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

Объявление

Objective C

void PBSetCatalogInfoAsync ( FSRefParam *paramBlock );

Параметры


      paramBlock

Указатель на блок параметра ссылки файловой системы. Посмотрите FSRefParam для описания FSRefParam тип данных.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции.
`ref`	На вводе, указателе на `FSRef` указание файла или каталога, информация которого должна быть изменена.
`whichInfo`	На вводе, битовый массив, указывающий, который поля информации о каталоге установить. Только некоторые поля информации о каталоге могут быть установлены. Эти поля даны константой `kFSCatInfoSettableInfo`; никакие другие биты не могут быть установлены в `whichInfo` поле. Посмотрите Растровые Константы информации о Каталоге для описания битов в этом поле. Для установки идентификатора пользователя (UID) и группа ID (GID) укажите `kFSCatInfoSetOwnership` флаг в этом поле. Файловый менеджер пытается установить пользователя и группу ID к значениям, указанным в `permissions` поле информационной структуры каталога. Если `PBSetCatalogInfoAsync` не может установить пользователя и группу IDs, она возвращает ошибку.
`catInfo`	На вводе, указателе на `FSCatalogInfo` структура, содержащая новую информацию о каталоге. Только некоторые поля информации о каталоге могут быть установлены. Поля, которые могут быть установлены: `createDate` `contentModDate` `attributeModDate` `accessDate` `backupDate` `permissions` `finderInfo` `extFinderInfo` `textEncodingHint`

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

Objective C

@import CoreServices;

Доступность

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

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


    
    FSpGetFInfo
    FSpGetFInfo

(OS X v10.4)

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

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

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

Объявление

Objective C

OSErr FSpGetFInfo ( const FSSpec *spec, FInfo *fndrInfo );

Параметры


      spec

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


      fndrInfo

По возврату указатель на информацию используется Средством поиска. FSpGetFInfo функционируйте возвращает информацию о Средстве поиска из каталогизационного описания объема для указанного файла. Функция предоставляет только исходную информацию Средства поиска — информация в FInfo или DInfo структуры, не информация в FXInfo или DXInfo структуры. Для описания FInfo структура, посмотрите Ссылку Интерфейса Средства поиска.

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

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

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

Objective C

@import CoreServices;

Доступность

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

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

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


    
    HGetFInfo
    HGetFInfo

(OS X v10.4)

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

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

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

Объявление

Objective C

OSErr HGetFInfo ( FSVolumeRefNum vRefNum, SInt32 dirID, ConstStr255Param fileName, FInfo *fndrInfo );

Параметры

`vRefNum`	Ссылочный номер объема, управляйте числом, или 0 для объема по умолчанию.
`dirID`	Родительский каталог ID файла.
`fileName`	Имя файла.
`fndrInfo`	По возврату указатель на информацию о Средстве поиска сохранен в каталоге указанного объема. Функция возвращает только исходную информацию о Средстве поиска — это содержало в `FInfo` структура, не это в `FXInfo` структура.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

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

Objective C

@import CoreServices;

Доступность

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

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

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


    
    PBHGetFInfoSync
    PBHGetFInfoSync

(OS X v10.4)

Получает информацию о файле.

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

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

Объявление

Objective C

OSErr PBHGetFInfoSync ( HParmBlkPtr paramBlock );

Параметры


      paramBlock

Указатель на HFileParam вариант основного блока параметра HFS. Посмотрите HParamBlockRec для описания HParamBlockRec тип данных.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioNamePtr`	На вводе, указателе на путь. Если значение `ioFDirIndex` поле отрицательно или 0, `PBHGetFInfoSync` информация о возвратах о файле в объеме, указанном ссылочным номером в `ioVRefNum` поле и давание имени здесь. На выводе, указателе на имя файла, если файл открыт. Если Вам не жаль, что имя не возвратилось, передача `NULL` здесь.
`ioVRefNum`	На вводе, ссылочном номере объема или числе диска для объема, содержащего файл, или 0 для объема по умолчанию.
`ioFRefNum`	Если файл открыт и если, на выводе ссылочный номер первого пути доступа нашел `ioFDirIndex` поле отрицательно или 0; если `ioFDirIndex` поле положительно...
`ioFDirIndex`	На вводе, индексе каталога. Если это значение положительно, функциональная информация о возвратах о файле, указывающем индекс каталога здесь, на объеме, указанном в `ioVRefNum` поле и в каталоге, указанном в `ioDirID` поле. Если это значение отрицательно или 0, функциональная информация о возвратах о файле на указанном объеме, указывая на имя в `ioNamePtr` поле.
`ioFlAttrib`	На выводе, атрибутах файла. Посмотрите Константы Атрибута файла для описания атрибутов файла.
`ioFlFndrInfo`	На выводе, информации о Средстве поиска о файле. Для описания `FInfo` тип данных, посмотрите Ссылку Интерфейса Средства поиска.
`ioDirID`	На вводе, родительский каталог ID файла. На выводе, идентификаторе файла файла.
`ioFVersNum`	На вводе это поле должно быть инициализировано для обнуления; если это поле не будет нулем, то вызов провалится к теперь устаревшему коду Macintosh File System (MFS), если объем получил доступ, объем MFS.
`ioFlStBlk`	На выводе, первом блоке выделения ветви данных.
`ioFlLgLen`	На выводе, логический размер (логический конец файла) ветви данных файла, в байтах.
`ioFlPyLen`	На выводе, физический размер (физический конец файла) ветви данных файла, в байтах.
`ioFlRStBlk`	На выводе, первом блоке выделения ветви ресурсов.
`ioFlRLgLen`	На выводе, логическом размере ветви ресурсов, в байтах.
`ioFlRPyLen`	На выводе, физическом размере ветви ресурсов, в байтах.
`ioFlCrDat`	На выводе, дате и времени создания файла.
`ioFlMdDat`	На выводе, дате и времени последнего изменения файла.

Необходимо вызвать PBHGetFInfoSync как раз перед PBHSetFInfoSync , так, чтобы текущая информация присутствовала в блоке параметра.

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

Objective C

@import CoreServices;

Доступность

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

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

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


    
    PBHGetFInfoAsync
    PBHGetFInfoAsync

(OS X v10.4)

Получает информацию о файле.

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

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

Объявление

Objective C

OSErr PBHGetFInfoAsync ( HParmBlkPtr paramBlock );

Параметры


      paramBlock

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на функцию завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции.
`ioNamePtr`	На вводе, указателе на путь. Если значение `ioFDirIndex` поле отрицательно или 0, `PBHGetFInfoAsync` информация о возвратах о файле в объеме, указанном ссылочным номером в `ioVRefNum` поле и давание имени здесь. На выводе, указателе на имя файла, если файл открыт. Если Вам не жаль, что имя не возвратилось, передача `NULL` здесь.
`ioVRefNum`	На вводе, ссылочном номере объема или числе диска для объема, содержащего файл, или 0 для объема по умолчанию.
`ioFRefNum`	Если файл открыт и если, на выводе ссылочный номер первого пути доступа нашел `ioFDirIndex` поле отрицательно или 0; если `ioFDirIndex` поле положительно...
`ioFDirIndex`	На вводе, индексе каталога. Если это значение положительно, функциональная информация о возвратах о файле, указывающем индекс каталога здесь, на объеме, указанном в `ioVRefNum` поле и в каталоге, указанном в `ioDirID` поле. Если это значение отрицательно или 0, функциональная информация о возвратах о файле на указанном объеме, указывая на имя в `ioNamePtr` поле.
`ioFlAttrib`	На выводе, атрибутах файла. Посмотрите Константы Атрибута файла для описания атрибутов файла.
`ioFlFndrInfo`	На выводе, информации о Средстве поиска о файле. Для описания `FInfo` структура, посмотрите Ссылку Интерфейса Средства поиска.
`ioDirID`	На вводе, родительский каталог ID файла. На выводе, идентификаторе файла файла.
`ioFVersNum`	На вводе это поле должно быть инициализировано для обнуления; если это поле не будет нулем, то вызов провалится к теперь устаревшему коду Macintosh File System (MFS), если объем получил доступ, объем MFS.
`ioFlStBlk`	На выводе, первом блоке выделения ветви данных.
`ioFlLgLen`	На выводе, логический размер (логический конец файла) ветви данных файла, в байтах.
`ioFlPyLen`	На выводе, физический размер (физический конец файла) ветви данных файла, в байтах.
`ioFlRStBlk`	На выводе, первом блоке выделения ветви ресурсов.
`ioFlRLgLen`	На выводе, логическом размере ветви ресурсов файла, в байтах.
`ioFlRPyLen`	На выводе, физическом размере ветви ресурсов файла, в байтах.
`ioFlCrDat`	На выводе, дате и времени создания файла.
`ioFlMdDat`	На выводе, дате и времени последнего изменения файла.

Необходимо вызвать PBHGetFInfoAsync как раз перед PBHSetFInfoAsync , так, чтобы текущая информация присутствовала в блоке параметра.

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

Objective C

@import CoreServices;

Доступность

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

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

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


    
    FSpSetFInfo
    FSpSetFInfo

(OS X v10.4)

Устанавливает информацию о Средстве поиска о файле.

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

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

Объявление

Objective C

OSErr FSpSetFInfo ( const FSSpec *spec, const FInfo *fndrInfo );

Параметры

`spec`	Указатель на `FSSpec` структура, указывающая файл, для которого можно установить информацию о Средстве поиска. Посмотрите `FSSpec` для описания `FSSpec` тип данных.
`fndrInfo`	Указатель на новую информацию о Средстве поиска. Для описания `FInfo` тип данных, посмотрите Ссылку Интерфейса Средства поиска.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

FSpSetFInfo функционируйте изменяет информацию о Средстве поиска в каталогизационном описании объема для указанного файла. FSpSetFInfo позволяет Вам устанавливать только исходную информацию о Средстве поиска — информация в FInfo или DInfo структуры, не информация в FXInfo или DXInfo структуры.

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

Objective C

@import CoreServices;

Доступность

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

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

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


    
    HSetFInfo
    HSetFInfo

(OS X v10.4)

Устанавливает информацию о Средстве поиска для файла.

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

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

Объявление

Objective C

OSErr HSetFInfo ( FSVolumeRefNum vRefNum, SInt32 dirID, ConstStr255Param fileName, const FInfo *fndrInfo );

Параметры

`vRefNum`	Ссылочный номер объема, управляйте числом, или 0 для объема по умолчанию.
`dirID`	Родительский каталог ID файла.
`fileName`	Имя файла.
`fndrInfo`	Указатель на новую информацию о Средстве поиска. Функция изменяет информацию Средства поиска, хранившую в каталоге объема. `HSetFInfo` изменения только исходная информация о Средстве поиска — это содержало в `FInfo` структура, не это содержало в `FXInfo` структура. Для описания `FInfo` тип данных, посмотрите Ссылку Интерфейса Средства поиска.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

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

Objective C

@import CoreServices;

Доступность

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

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

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


    
    PBHSetFInfoSync
    PBHSetFInfoSync

(OS X v10.4)

Информация о наборах для файла.

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

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

Объявление

Objective C

OSErr PBHSetFInfoSync ( HParmBlkPtr paramBlock );

Параметры


      paramBlock

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioNamePtr`	На вводе, указателе на имя файла.
`ioVRefNum`	На вводе, ссылочном номере объема или числе диска для объема, содержащего файл; или 0 для объема по умолчанию.
`ioFlFndrInfo`	На вводе, информации о Средстве поиска для файла. Для описания `FInfo` тип данных, посмотрите Ссылку Интерфейса Средства поиска.
`ioDirID`	На вводе, родительский каталог ID файла.
`ioFVersNum`	На вводе это поле должно быть инициализировано для обнуления; если это поле не будет нулем, то вызов провалится к теперь устаревшему коду Macintosh File System (MFS), если объем получил доступ, объем MFS.
`ioFlCrDat`	На вводе, дате и времени создания файла.
`ioFlMdDat`	На вводе, дате и времени последнего изменения файла.

Необходимо вызвать PBHGetFInfoSync функция как раз перед вызовом PBHSetFInfoSync, так, чтобы текущая информация присутствовала в блоке параметра.

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

Objective C

@import CoreServices;

Доступность

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

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

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


    
    PBHSetFInfoAsync
    PBHSetFInfoAsync

(OS X v10.4)

Информация о наборах для файла.

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

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

Объявление

Objective C

OSErr PBHSetFInfoAsync ( HParmBlkPtr paramBlock );

Параметры


      paramBlock

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на функцию завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции.
`ioNamePtr`	На вводе, указателе на имя файла.
`ioVRefNum`	На вводе, ссылочном номере объема или числе диска для объема, содержащего файл; или 0 для объема по умолчанию.
`ioFlFndrInfo`	На вводе, информации о Средстве поиска для файла. Для описания `FInfo` тип данных, посмотрите Ссылку Интерфейса Средства поиска.
`ioDirID`	На вводе, родительский каталог ID для файла.
`ioFVersNum`	На вводе это поле должно быть инициализировано для обнуления; если это поле не будет нулем, то вызов провалится к теперь устаревшему коду Macintosh File System (MFS), если объем получил доступ, объем MFS.
`ioFlCrDat`	На вводе, дате и времени создания файла.
`ioFlMdDat`	На вводе, дате и времени последнего изменения файла.

Необходимо вызвать PBHGetFInfoAsync функция как раз перед вызовом PBHSetFInfoAsync, так, чтобы текущая информация присутствовала в блоке параметра.

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

Objective C

@import CoreServices;

Доступность

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

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

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

Доступ к настольной базе данных


    
    PBDTAddIconSync
    PBDTAddIconSync

(OS X v10.4)

Добавляет определение значка настольной базе данных.

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

Нет никакой заменяющей функции.

Объявление

Objective C

OSErr PBDTAddIconSync ( DTPBPtr paramBlock );

Параметры


      paramBlock

Указатель на настольный блок параметра базы данных. Посмотрите DTPBRec для описания DTPBRec тип данных.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра для этой функции:

`ioDTRefNum`	На вводе, настольном числе ссылки на базу данных базы данных, к которой Вы хотите добавить значок.
`ioTagInfo`	Зарезервированный; на вводе это поле должно быть установлено в 0.
`ioDTBuffer`	На вводе, указателе на буфер, содержащий битовый массив значка.
`ioDTReqCount`	На вводе, размере в байтах буфера, который Вы выделили для битового массива значка. Это значение зависит от типа значков. Обязательно выделите достаточно хранения для данных значка, 1 024 байта являются самой большой суммой, требуемой для любого значка в Системе 7 Для описания значений, которые можно использовать, чтобы указать размер значка, видеть Константы Размера значков.
`ioIconType`	На вводе, типе значков. Посмотрите Константы Типа значков для описания значений, которые можно использовать в этом поле.
`ioFileCreator`	На вводе, создателе файла значка.
`ioFileType`	На вводе, типе файла значка.

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

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

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

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

Objective C

@import CoreServices;

Доступность

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

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

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


    
    PBDTAddIconAsync
    PBDTAddIconAsync

(OS X v10.4)

Добавляет определение значка настольной базе данных.

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

Нет никакой заменяющей функции.

Объявление

Objective C

OSErr PBDTAddIconAsync ( DTPBPtr paramBlock );

Параметры


      paramBlock

Указатель на настольный блок параметра базы данных. Посмотрите DTPBRec для описания DTPBRec тип данных.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра для этой функции:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции. См. “Коды Результата Файлового менеджера”.
`ioDTRefNum`	На вводе, настольном числе ссылки на базу данных базы данных, к которой Вы хотите добавить значок.
`ioTagInfo`	Зарезервированный; на вводе это поле должно быть установлено в 0.
`ioDTBuffer`	На вводе, указателе на буфер, содержащий битовый массив значка.
`ioDTReqCount`	На вводе, размере в байтах буфера, который Вы выделили для битового массива значка. Это значение зависит от типа значков. Обязательно выделите достаточно хранения для данных значка, 1 024 байта являются самой большой суммой, требуемой для любого значка в Системе 7. Для описания значений можно использовать, чтобы указать размер значка, видеть Константы Размера значков.
`ioIconType`	На вводе, типе значков. Посмотрите Константы Типа значков для описания значений, которые можно использовать в этом поле.
`ioFileCreator`	На вводе, создателе файла значка.
`ioFileType`	На вводе, типе файла значка.

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

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

Objective C

@import CoreServices;

Доступность

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

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

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


    
    PBDTAddAPPLSync
    PBDTAddAPPLSync

(OS X v10.4)

Добавляет приложение на настольную базу данных.

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

Нет никакой заменяющей функции.

Объявление

Objective C

OSErr PBDTAddAPPLSync ( DTPBPtr paramBlock );

Параметры


      paramBlock

Указатель на настольный блок параметра базы данных. Посмотрите DTPBRec для описания DTPBRec тип данных.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра для этой функции:

`ioNamePtr`	На вводе, указателе на имя приложения.
`ioDTRefNum`	На вводе, настольном числе ссылки на базу данных настольной базы данных, на которую Вы хотите добавить приложение.
`ioTagInfo`	Зарезервированный; на вводе это поле должно быть установлено в 0.
`ioDirID`	На вводе, ID родительского каталога приложения.
`ioFileCreator`	На вводе, подписи приложения.

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

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

Objective C

@import CoreServices;

Доступность

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

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

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


    
    PBDTAddAPPLAsync
    PBDTAddAPPLAsync

(OS X v10.4)

Добавляет приложение на настольную базу данных.

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

Нет никакой заменяющей функции.

Объявление

Objective C

OSErr PBDTAddAPPLAsync ( DTPBPtr paramBlock );

Параметры


      paramBlock

Указатель на настольный блок параметра базы данных. Посмотрите DTPBRec для описания DTPBRec тип данных.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра для этой функции:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции. См. “Коды Результата Файлового менеджера”.
`ioNamePtr`	На вводе, указателе на имя приложения.
`ioDTRefNum`	На вводе, настольном числе ссылки на базу данных настольной базы данных, на которую Вы хотите добавить приложение.
`ioTagInfo`	Зарезервированный; на вводе это поле должно быть установлено в 0.
`ioDirID`	На вводе, ID родительского каталога приложения.
`ioFileCreator`	На вводе, подписи приложения.

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

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

Objective C

@import CoreServices;

Доступность

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

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

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


    
    PBDTCloseDown
    PBDTCloseDown

(OS X v10.4)

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

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

Нет никакой заменяющей функции.

Объявление

Objective C

OSErr PBDTCloseDown ( DTPBPtr paramBlock );

Параметры


      paramBlock

Указатель на настольный блок параметра базы данных. Посмотрите DTPBRec для описания DTPBRec тип данных.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующее поле блока параметра для этой функции:


      ioDTRefNum

На вводе, настольном числе ссылки на базу данных.

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

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

Когда PBDTCloseDown функционируйте закрывает базу данных, она освобождает все ресурсы, выделенные PBDTOpenInform или PBDTGetPath.

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

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

Objective C

@import CoreServices;

Доступность

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

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

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


    
    PBDTDeleteSync
    PBDTDeleteSync

(OS X v10.4)

Удаляет настольную базу данных. Если Вы не управляете настольной базой данных в отсутствие Средства поиска, Вы никогда не должны использовать эту функцию.

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

Нет никакой заменяющей функции.

Объявление

Objective C

OSErr PBDTDeleteSync ( DTPBPtr paramBlock );

Параметры


      paramBlock

Указатель на настольный блок параметра базы данных. Посмотрите DTPBRec для описания DTPBRec тип данных.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

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

Соответствующие поля блока параметра для этой функции:

`ioVRefNum`	На вводе, ссылочном номере объема настольной базы данных для удаления.
`ioIndex`	Зарезервированный; на вводе это поле должно быть установлено в 0.

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

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

Objective C

@import CoreServices;

Доступность

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

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

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


    
    PBDTDeleteAsync
    PBDTDeleteAsync

(OS X v10.4)

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

Нет никакой заменяющей функции.

Объявление

Objective C

OSErr PBDTDeleteAsync ( DTPBPtr paramBlock );

Параметры


      paramBlock

Указатель на настольный блок параметра базы данных. Посмотрите DTPBRec для описания DTPBRec тип данных.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

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

Соответствующие поля блока параметра для этой функции:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции. См. “Коды Результата Файлового менеджера”.
`ioVRefNum`	На вводе, ссылочном номере объема настольной базы данных для удаления.
`ioIndex`	Зарезервированный; на вводе это поле должно быть установлено в 0.

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

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

Objective C

@import CoreServices;

Доступность

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

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

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


    
    PBDTFlushSync
    PBDTFlushSync

(OS X v10.4)

Сохраняет Ваши изменения в настольной базе данных.

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

Нет никакой заменяющей функции.

Объявление

Objective C

OSErr PBDTFlushSync ( DTPBPtr paramBlock );

Параметры


      paramBlock

Указатель на настольный блок параметра базы данных. Посмотрите DTPBRec для описания DTPBRec тип данных.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

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

Соответствующее поле блока параметра для этой функции:


      ioDTRefNum

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

Необходимо вызвать PBDTFlushSync или PBDTFlushAsync если Ваше приложение управляло информацией в базе данных с помощью какой-либо из следующих функций, обновить копию настольной базы данных сохранило на объеме:

PBDTAddIconSync
PBDTAddIconAsync
PBDTAddAPPLSync
PBDTAddAPPLAsync
PBDTSetCommentSync
PBDTSetCommentAsync
PBDTRemoveAPPLSync
PBDTRemoveAPPLAsync
PBDTRemoveCommentSync
PBDTRemoveCommentAsync

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

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

Objective C

@import CoreServices;

Доступность

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

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

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


    
    PBDTFlushAsync
    PBDTFlushAsync

(OS X v10.4)

Сохраняет Ваши изменения в настольной базе данных.

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

Нет никакой заменяющей функции.

Объявление

Objective C

OSErr PBDTFlushAsync ( DTPBPtr paramBlock );

Параметры


      paramBlock

Указатель на настольный блок параметра базы данных. Посмотрите DTPBRec для описания DTPBRec тип данных.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

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

Соответствующие поля блока параметра для этой функции:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции. См. “Коды Результата Файлового менеджера”.
`ioDTRefNum`	На вводе, настольном числе ссылки на базу данных настольной базы данных для сбрасывания.

Необходимо вызвать PBDTFlushAsync или PBDTFlushSync если Ваше приложение управляло информацией в базе данных с помощью какой-либо из следующих функций, обновить копию настольной базы данных сохранило на объеме:

PBDTAddIconSync
PBDTAddIconAsync
PBDTAddAPPLSync
PBDTAddAPPLAsync
PBDTSetCommentSync
PBDTSetCommentAsync
PBDTRemoveAPPLSync
PBDTRemoveAPPLAsync
PBDTRemoveCommentSync
PBDTRemoveCommentAsync

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

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

Objective C

@import CoreServices;

Доступность

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

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

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


    
    PBDTGetAPPLSync
    PBDTGetAPPLSync

(OS X v10.4)

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

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

Нет никакой заменяющей функции.

Объявление

Objective C

OSErr PBDTGetAPPLSync ( DTPBPtr paramBlock );

Параметры


      paramBlock

Указатель на настольный блок параметра базы данных. Посмотрите DTPBRec для описания DTPBRec тип данных.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра для этой функции:

`ioNamePtr`	На выводе, указателе на имя приложения.
`ioDTRefNum`	На вводе, настольном числе ссылки на базу данных настольной базы данных, содержащей указанное приложение.
`ioIndex`	На вводе, индексе в список приложений.
`ioTagInfo`	На выводе, дате создания приложения.
`ioFileCreator`	На вводе, подписи приложения.
`ioAPPLParID`	На выводе, родительском каталоге приложения.

Единственный вызов, с ioIndex полевой набор к 0, находит файл приложения с новой датой создания. Если Вы хотите получить информацию обо всех копиях приложения с данной подписью, запустите с ioIndex набор к 1 и инкремент это значение 1 с каждым вызовом к PBDTGetAPPLSync до кода результата afpItemNotFound возвращается в ioResult поле; когда вызвано многократно этим способом, PBDTGetAPPLSync информация о возвратах о копиях всего приложения, включая файл с новой датой создания, в произвольном порядке.

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

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

Objective C

@import CoreServices;

Доступность

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

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

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


    
    PBDTGetAPPLAsync
    PBDTGetAPPLAsync

(OS X v10.4)

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

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

Нет никакой заменяющей функции.

Объявление

Objective C

OSErr PBDTGetAPPLAsync ( DTPBPtr paramBlock );

Параметры


      paramBlock

Указатель на настольный блок параметра базы данных. Посмотрите DTPBRec для описания DTPBRec тип данных.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра для этой функции:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата. См. “Коды Результата Файлового менеджера”.
`ioNamePtr`	На выводе, указателе на имя приложения.
`ioDTRefNum`	На вводе, настольном числе ссылки на базу данных настольной базы данных, содержащей указанное приложение.
`ioIndex`	На вводе, индексе в список приложений.
`ioTagInfo`	На выводе, дате создания приложения.
`ioFileCreator`	На вводе, подписи приложения.
`ioAPPLParID`	На выводе, родительском каталоге приложения.

Единственный вызов, с ioIndex полевой набор к 0, находит файл приложения с новой датой создания. Если Вы хотите получить информацию обо всех копиях приложения с данной подписью, запустите с ioIndex набор к 1 и инкремент это значение 1 с каждым вызовом к PBDTGetAPPLAsync до кода результата afpItemNotFound возвращается в ioResult поле; когда вызвано многократно этим способом, PBDTGetAPPLAsync информация о возвратах о копиях всего приложения, включая файл с новой датой создания, в произвольном порядке.

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

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

Objective C

@import CoreServices;

Доступность

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

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

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


    
    PBDTGetCommentSync
    PBDTGetCommentSync

(OS X v10.4)

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

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

Нет никакой заменяющей функции.

Объявление

Objective C

OSErr PBDTGetCommentSync ( DTPBPtr paramBlock );

Параметры


      paramBlock

Указатель на настольный блок параметра базы данных. Посмотрите DTPBRec для описания DTPBRec тип данных.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра для этой функции:

`ioNamePtr`	На вводе, указателе на имя файла или каталога, для которого Вы хотите получить комментарии.
`ioDTRefNum`	На вводе, настольном числе ссылки на базу данных базы данных, в которой найден указанный файл или каталог.
`ioDTBuffer`	На вводе, указателе на буфер, выделенный для содержания текста комментария. На выводе, указателе на текст комментария. Выделите буферные по крайней мере 255 байтов в размере. `PBDTGetCommentSync` функционируйте места до `ioDTReqCount` байты комментария в буфер как строка обычного текста и места фактическая длина комментария в `ioDTActCount` поле.
`ioDTReqCount`	На вводе, размере буфера, выделенного для содержания комментария.
`ioDTActCount`	На выводе, размере комментария.
`ioDirID`	На вводе, родительском каталоге файла или каталога.

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

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

Objective C

@import CoreServices;

Доступность

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

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

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


    
    PBDTGetCommentAsync
    PBDTGetCommentAsync

(OS X v10.4)

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

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

Нет никакой заменяющей функции.

Объявление

Objective C

OSErr PBDTGetCommentAsync ( DTPBPtr paramBlock );

Параметры


      paramBlock

Указатель на настольный блок параметра базы данных. Посмотрите DTPBRec для описания DTPBRec тип данных.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра для этой функции:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции. См. “Коды Результата Файлового менеджера”.
`ioNamePtr`	На вводе, указателе на имя файла или каталога, для которого Вы хотите получить комментарии.
`ioDTRefNum`	На вводе, настольном числе ссылки на базу данных базы данных, в которой найден указанный файл или каталог.
`ioDTBuffer`	На вводе, указателе на буфер, выделенный для содержания текста комментария. На выводе, указателе на текст комментария. Выделите буферные по крайней мере 255 байтов в размере. `PBDTGetCommentAsync` функционируйте места до `ioDTReqCount` байты комментария в буфер как строка обычного текста и места фактическая длина комментария в `ioDTActCount` поле.
`ioDTReqCount`	На вводе, размере буфера, выделенного для содержания комментария.
`ioDTActCount`	На выводе, размере комментария.
`ioDirID`	На вводе, родительском каталоге файла или каталога.

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

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

Objective C

@import CoreServices;

Доступность

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

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

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


    
    PBDTGetIconSync
    PBDTGetIconSync

(OS X v10.4)

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

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

Нет никакой заменяющей функции.

Объявление

Objective C

OSErr PBDTGetIconSync ( DTPBPtr paramBlock );

Параметры


      paramBlock

Указатель на настольный блок параметра базы данных. Посмотрите DTPBRec для описания DTPBRec тип данных.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

PBDTGetIconSync функционируйте возвращает битовый массив для значка, представляющего файл данного типа и создателя. Например, для получения значка для файла типа файла 'SFWR' создаваемый приложением с подписью 'WAVE', укажите эти два значения в ioFileType и ioFileCreator поля.

Соответствующие поля блока параметра для этой функции:

`ioDTRefNum`	На вводе, настольном числе ссылки на базу данных.
`ioTagInfo`	Зарезервированный; на вводе это поле должно быть установлено в 0.
`ioDTBuffer`	На вводе, указателе на буфер для содержания данных значка. По возврату указатель на битовый массив возвратился в буфере.
`ioDTReqCount`	На вводе, требуемом размере битового массива значка. Передайте размер в байтах буфера, который Вы выделили для битового массива значка, на который указывают `ioDTBuffer` поле; это значение зависит от типа значков. Обязательно выделите достаточно хранения для данных значка; 1 024 байта являются самой большой суммой, требуемой для любого значка в Системе 7. Можно использовать константы, описанные в Константах Размера значков для указания объема памяти, Вы предусмотрели данные значка.
`ioDTActCount`	На выводе, фактическом размере битового массива значка. Если это значение больше, чем значение, указанное в `ioDTReqCount` поле, только объем данных, позволенный `ioDTReqCount` допустимо.
`ioIconType`	На вводе, типе значков. Для описания констант, которые можно использовать в этом поле, посмотрите Константы Типа значков.
`ioFileCreator`	На вводе, создателе файла значка.
`ioFileType`	На вводе, типе файла значка.

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

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

Objective C

@import CoreServices;

Доступность

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

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

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


    
    PBDTGetIconAsync
    PBDTGetIconAsync

(OS X v10.4)

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

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

Нет никакой заменяющей функции.

Объявление

Objective C

OSErr PBDTGetIconAsync ( DTPBPtr paramBlock );

Параметры


      paramBlock

Указатель на настольный блок параметра базы данных. Посмотрите DTPBRec для описания DTPBRec тип данных.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

PBDTGetIconAsync функционируйте возвращает битовый массив для значка, представляющего файл данного типа и создателя. Например, для получения значка для файла типа файла 'SFWR' создаваемый приложением с подписью 'WAVE', укажите эти два значения в ioFileType и ioFileCreator поля.

Соответствующие поля блока параметра для этой функции:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции. См. “Коды Результата Файлового менеджера”.
`ioDTRefNum`	На вводе, настольном числе ссылки на базу данных.
`ioTagInfo`	Зарезервированный; на вводе это поле должно быть установлено в 0.
`ioDTBuffer`	На вводе, указателе на буфер для содержания данных значка. По возврату указатель на битовый массив возвратился в буфере.
`ioDTReqCount`	На вводе, требуемом размере битового массива значка. Передайте размер в байтах буфера, который Вы выделили для битового массива значка, на который указывают `ioDTBuffer` поле; это значение зависит от типа значков. Обязательно выделите достаточно хранения для данных значка; 1 024 байта являются самой большой суммой, требуемой для любого значка в Системе 7. Можно использовать константы, описанные в Константах Размера значков для указания объема памяти, Вы предусмотрели данные значка.
`ioDTActCount`	По возврату, фактическому размеру битового массива значка. Если это значение больше, чем значение, указанное в `ioDTReqCount` поле, только объем данных, позволенный значением в `ioDTReqCount` поле допустимо.
`ioIconType`	На вводе, типе значков. Для описания констант, которые можно использовать в этом поле, посмотрите Константы Типа значков.
`ioFileCreator`	На вводе, создателе файла значка.
`ioFileType`	На вводе, типе файла значка.

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

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

Objective C

@import CoreServices;

Доступность

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

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

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


    
    PBDTGetIconInfoSync
    PBDTGetIconInfoSync

(OS X v10.4)

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

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

Нет никакой заменяющей функции.

Объявление

Objective C

OSErr PBDTGetIconInfoSync ( DTPBPtr paramBlock );

Параметры


      paramBlock

Указатель на настольный блок параметра базы данных. Посмотрите DTPBRec для описания DTPBRec тип данных.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра для этой функции:

`ioDTRefNum`	На вводе, настольном числе ссылки на базу данных.
`ioIndex`	На вводе, индексе в список значка.
`ioTagInfo`	Зарезервированный; на вводе это поле должно быть установлено в 0.
`ioDTActCount`	На выводе, размере битового массива значка.
`ioIconType`	На выводе, типе значков, включая размер значков и глубину цвета. Для описания значений, которые могут быть возвращены в этом поле, посмотрите Константы Типа значков. Проигнорируйте любые значения, возвращенные в `ioIconType` это не перечислено там; они представляют специальные значки и информацию, используемую только Средством поиска.
`ioFileCreator`	На вводе, создателе файла значка.
`ioFileType`	На выводе, типе файла значка.

Для продвижения через список типов значков и типов файлов, поддерживаемых приложением, выполните повторенные вызовы к PBDTGetIconInfoSync, указание создателя и индекса оценивает в ioIndex поле для каждого вызова. Установите индекс в 1 на первом вызове и постепенно увеличьте его на каждом последующем вызове до кода результата afpItemNotFound возвращается в ioResult поле.

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

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

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

Objective C

@import CoreServices;

Доступность

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

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

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


    
    PBDTGetIconInfoAsync
    PBDTGetIconInfoAsync

(OS X v10.4)

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

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

Нет никакой заменяющей функции.

Объявление

Objective C

OSErr PBDTGetIconInfoAsync ( DTPBPtr paramBlock );

Параметры


      paramBlock

Указатель на настольный блок параметра базы данных. Посмотрите DTPBRec для описания DTPBRec тип данных.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра для этой функции:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции. См. “Коды Результата Файлового менеджера”.
`ioDTRefNum`	На вводе, настольном числе ссылки на базу данных.
`ioIndex`	На вводе, индексе в список значка.
`ioTagInfo`	Зарезервированный; на вводе это поле должно быть установлено в 0.
`ioDTActCount`	На выводе, размере битового массива значка.
`ioIconType`	На выводе, типе значков, включая размер значков и глубину цвета. Для описания значений, которые могут быть возвращены в этом поле, посмотрите Константы Типа значков. Проигнорируйте любые значения, возвращенные в `ioIconType` это не перечислено там; они представляют специальные значки и информацию, используемую только Средством поиска.
`ioFileCreator`	На вводе, создателе файла значка.
`ioFileType`	На выводе, типе файла значка.

Для продвижения через список типов значков и типов файлов, поддерживаемых приложением, выполните повторенные вызовы к PBDTGetIconInfoAsync, указание создателя и индекса оценивает в ioIndex поле для каждого вызова. Установите индекс в 1 на первом вызове и постепенно увеличьте его на каждом последующем вызове до кода результата afpItemNotFound возвращается в ioResult поле.

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

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

Objective C

@import CoreServices;

Доступность

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

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

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


    
    PBDTGetInfoSync
    PBDTGetInfoSync

(OS X v10.4)

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

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

Нет никакой заменяющей функции.

Объявление

Objective C

OSErr PBDTGetInfoSync ( DTPBPtr paramBlock );

Параметры


      paramBlock

Указатель на настольный блок параметра базы данных. Посмотрите DTPBRec для описания DTPBRec тип данных.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра для этой функции:

`ioVRefNum`	На выводе, ссылочном номере объема объема, где хранятся файлы базы данных.
`ioDTRefNum`	На вводе, настольном числе ссылки на базу данных базы данных, о которой Вы хотите получить информацию.
`ioIndex`	На выводе, числе файлов, включающих настольную базу данных по объему.
`ioDirID`	На выводе, родительский каталог ID настольной базы данных.
`ioDTLgLen`	На выводе, логической длине файлов базы данных (сумма логических длин файлов, составляющих настольную базу данных для данного объема).
`ioDTPyLen`	На выводе, физической длине файлов базы данных (сумма физических длин файлов, составляющих настольную базу данных для данного объема).

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

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

Objective C

@import CoreServices;

Доступность

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

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

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


    
    PBDTGetInfoAsync
    PBDTGetInfoAsync

(OS X v10.4)

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

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

Нет никакой заменяющей функции.

Объявление

Objective C

OSErr PBDTGetInfoAsync ( DTPBPtr paramBlock );

Параметры


      paramBlock

Указатель на настольный блок параметра базы данных. Посмотрите DTPBRec для описания DTPBRec тип данных.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра для этой функции:

`ioCompletion`	На вводе, указателе на функцию завершения. Для получения дополнительной информации о функциях завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции. См. “Коды Результата Файлового менеджера”.
`ioVRefNum`	На выводе, ссылочном номере объема объема, где хранятся файлы базы данных.
`ioDTRefNum`	На вводе, настольном числе ссылки на базу данных базы данных, о которой Вы хотите получить информацию.
`ioIndex`	На выводе, числе файлов, включающих настольную базу данных по объему.
`ioDirID`	На выводе, родительский каталог ID настольной базы данных.
`ioDTLgLen`	На выводе, логической длине файлов базы данных (сумма логических длин файлов, составляющих настольную базу данных для данного объема).
`ioDTPyLen`	На выводе, физической длине файлов базы данных (сумма физических длин файлов, составляющих настольную базу данных для данного объема).

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

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

Objective C

@import CoreServices;

Доступность

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

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

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


    
    PBDTGetPath
    PBDTGetPath

(OS X v10.4)

Получает ссылочный номер указанной настольной базы данных.

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

Нет никакой заменяющей функции.

Объявление

Objective C

OSErr PBDTGetPath ( DTPBPtr paramBlock );

Параметры


      paramBlock

Указатель на настольный блок параметра базы данных. Посмотрите DTPBRec для описания DTPBRec тип данных.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра для этой функции:

`ioNamePtr`	На вводе указатель на имя объема связался с настольной базой данных или полным путем настольной базы данных.
`ioVRefNum`	На вводе ссылочный номер объема объема связался с настольной базой данных.
`ioDTRefNum`	На выводе, настольном числе ссылки на базу данных, представляющем путь доступа базе данных. Вы не можете использовать настольный ссылочный номер в качестве числа ссылки на файл ни в каких функциях Файлового менеджера кроме настольных функций базы данных. Если `PBDTGetPath` сбои, это устанавливает это поле в 0.

Если настольная база данных не уже открыта, PBDTGetPath открывает его и затем возвращает ссылочный номер. Если настольная база данных не существует, PBDTGetPath создает его.

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

PBDTGetPath выделяет память в системной «куче»; не вызывайте его во время прерывания.

Эта функция выполняется синхронно только.

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

Objective C

@import CoreServices;

Доступность

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

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

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


    
    PBDTOpenInform
    PBDTOpenInform

(OS X v10.4)

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

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

Нет никакой заменяющей функции.

Объявление

Objective C

OSErr PBDTOpenInform ( DTPBPtr paramBlock );

Параметры


      paramBlock

Указатель на настольный блок параметра базы данных. Посмотрите DTPBRec для описания DTPBRec тип данных.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра для этой функции:

`ioNamePtr`	На вводе указатель на имя объема связался с настольной базой данных или полным путем настольной базы данных.
`ioVRefNum`	На вводе ссылочный номер объема объема связался с настольной базой данных.
`ioDTRefNum`	На выводе, настольном числе ссылки на базу данных, представляющем путь доступа базе данных. Вы не можете использовать настольный ссылочный номер в качестве числа ссылки на файл ни в каких функциях Файлового менеджера кроме настольных функций базы данных. Если `PBDTOpenInform` сбои, это устанавливает это поле в 0.
`ioTagInfo`	На выводе, флаг возврата (в младшем бите этого поля). Если настольная база данных была просто создана в ответ на `PBDTOpenInform` (и поэтому пусто), `PBDTOpenInform` устанавливает младший бит в этом поле к 0. Если настольная база данных была создана перед вызовом `PBDTOpenInform`, `PBDTOpenInform` устанавливает младший бит в этом поле к 1.

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

Эта функция выполняется синхронно только.

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

Objective C

@import CoreServices;

Доступность

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

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

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


    
    PBDTRemoveAPPLSync
    PBDTRemoveAPPLSync

(OS X v10.4)

Удаляет приложение из настольной базы данных.

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

Нет никакой заменяющей функции.

Объявление

Objective C

OSErr PBDTRemoveAPPLSync ( DTPBPtr paramBlock );

Параметры


      paramBlock

Указатель на настольный блок параметра базы данных. Посмотрите DTPBRec для описания DTPBRec тип данных.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

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

Соответствующие поля блока параметра для этой функции:

`ioNamePtr`	На вводе, указателе на имя приложения.
`ioDTRefNum`	На вводе, настольном числе ссылки на базу данных настольной базы данных, содержащей приложение.
`ioDirID`	На вводе, родительском каталоге приложения.
`ioFileCreator`	На вводе, подписи приложения.

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

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

Objective C

@import CoreServices;

Доступность

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

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

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


    
    PBDTRemoveAPPLAsync
    PBDTRemoveAPPLAsync

(OS X v10.4)

Удаляет приложение из настольной базы данных.

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

Нет никакой заменяющей функции.

Объявление

Objective C

OSErr PBDTRemoveAPPLAsync ( DTPBPtr paramBlock );

Параметры


      paramBlock

Указатель на настольный блок параметра базы данных. Посмотрите DTPBRec для описания DTPBRec тип данных.

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

Код результата. Посмотрите Коды Результата Файлового менеджера. Когда обращено объем CD HFS, PBDTRemoveAPPL возвращает afpItemNotFound ошибку вместо заблокированной ошибки ожидаемого объема (wPrErr).

Обсуждение

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

Соответствующие поля блока параметра для этой функции:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции. См. “Коды Результата Файлового менеджера”.
`ioNamePtr`	На вводе, указателе на имя приложения.
`ioDTRefNum`	На вводе, настольном числе ссылки на базу данных настольной базы данных, содержащей приложение.
`ioDirID`	На вводе, родительском каталоге приложения.
`ioFileCreator`	На вводе, подписи приложения.

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

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

Objective C

@import CoreServices;

Доступность

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

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

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


    
    PBDTRemoveCommentSync
    PBDTRemoveCommentSync

(OS X v10.4)

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

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

Нет никакой заменяющей функции.

Объявление

Objective C

OSErr PBDTRemoveCommentSync ( DTPBPtr paramBlock );

Параметры


      paramBlock

Указатель на настольный блок параметра базы данных. Посмотрите DTPBRec для описания DTPBRec тип данных.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра для этой функции:

`ioNamePtr`	На вводе, указателе на имя файла или имя каталога.
`ioDTRefNum`	На вводе, настольном числе ссылки на базу данных базы данных, в которой найден указанный файл или каталог.
`ioDirID`	На вводе, родительский каталог ID файла или каталога.

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

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

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

Objective C

@import CoreServices;

Доступность

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

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

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


    
    PBDTRemoveCommentAsync
    PBDTRemoveCommentAsync

(OS X v10.4)

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

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

Нет никакой заменяющей функции.

Объявление

Objective C

OSErr PBDTRemoveCommentAsync ( DTPBPtr paramBlock );

Параметры


      paramBlock

Указатель на настольный блок параметра базы данных. Посмотрите DTPBRec для описания DTPBRec тип данных.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра для этой функции:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции. См. “Коды Результата Файлового менеджера”.
`ioNamePtr`	На вводе, указателе на имя файла или имя каталога.
`ioDTRefNum`	На вводе, настольном числе ссылки на базу данных базы данных, в которой найден указанный файл или каталог.
`ioDirID`	На вводе, родительский каталог ID файла или каталога.

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

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

Objective C

@import CoreServices;

Доступность

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

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

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


    
    PBDTResetSync
    PBDTResetSync

(OS X v10.4)

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

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

Нет никакой заменяющей функции.

Объявление

Objective C

OSErr PBDTResetSync ( DTPBPtr paramBlock );

Параметры


      paramBlock

Указатель на настольный блок параметра базы данных. Посмотрите DTPBRec для описания DTPBRec тип данных.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

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

Соответствующие поля блока параметра для этой функции:

`ioDTRefNum`	На вводе, настольном числе ссылки на базу данных настольной базы данных для очистки.
`ioIndex`	Зарезервированный; на вводе это поле должно быть установлено в 0.

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

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

Objective C

@import CoreServices;

Доступность

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

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

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


    
    PBDTResetAsync
    PBDTResetAsync

(OS X v10.4)

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

Нет никакой заменяющей функции.

Объявление

Objective C

OSErr PBDTResetAsync ( DTPBPtr paramBlock );

Параметры


      paramBlock

Указатель на настольный блок параметра базы данных. Посмотрите DTPBRec для описания DTPBRec тип данных.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

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

Соответствующие поля блока параметра для этой функции:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции. См. “Коды Результата Файлового менеджера”.
`ioDTRefNum`	На вводе, настольном числе ссылки на базу данных настольной базы данных для очистки.
`ioIndex`	Зарезервированный; на вводе это поле должно быть установлено в 0.

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

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

Objective C

@import CoreServices;

Доступность

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

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

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


    
    PBDTSetCommentSync
    PBDTSetCommentSync

(OS X v10.4)

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

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

Нет никакой заменяющей функции.

Объявление

Objective C

OSErr PBDTSetCommentSync ( DTPBPtr paramBlock );

Параметры


      paramBlock

Указатель на настольный блок параметра базы данных. Посмотрите DTPBRec для описания DTPBRec тип данных.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра для этой функции:

`ioNamePtr`	На вводе, указателе на имя файла или каталога.
`ioDTRefNum`	На вводе, настольном числе ссылки на базу данных для настольной базы данных, к которой можно добавить комментарий пользователя.
`ioDTBuffer`	На вводе, указателе на буфер, содержащий текст комментария. Поместите комментарий в буфер как строка обычного текста.
`ioDTReqCount`	На вводе, длине буфера, содержащего текст комментария, в байтах. Максимальная длина комментария составляет 200 байтов; более длинные комментарии являются усеченными. Так как комментарий является строкой обычного текста и не строкой Паскаля, Файловый менеджер полагается на значение в `ioDTReqCount` поле для определения длины буфера.
`ioDirID`	На вводе, родительский каталог ID файла или каталога.

Если указанный объект уже имеет комментарий в базе данных, новый комментарий заменяет старое.

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

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

Objective C

@import CoreServices;

Доступность

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

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

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


    
    PBDTSetCommentAsync
    PBDTSetCommentAsync

(OS X v10.4)

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

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

Нет никакой заменяющей функции.

Объявление

Objective C

OSErr PBDTSetCommentAsync ( DTPBPtr paramBlock );

Параметры


      paramBlock

Указатель на настольный блок параметра базы данных. Посмотрите DTPBRec для описания DTPBRec тип данных.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра для этой функции:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции. См. “Коды Результата Файлового менеджера”.
`ioNamePtr`	На вводе, указателе на имя файла или каталога.
`ioDTRefNum`	На вводе, настольном числе ссылки на базу данных для настольной базы данных, к которой можно добавить комментарий пользователя.
`ioDTBuffer`	На вводе, указателе на буфер, содержащий текст комментария. Поместите комментарий в буфер как строка обычного текста.
`ioDTReqCount`	На вводе, длине буфера (в байтах) содержащий текст комментария. Максимальная длина комментария составляет 200 байтов; более длинные комментарии являются усеченными. Так как комментарий является строкой обычного текста и не строкой Паскаля, Файловый менеджер полагается на значение в `ioDTReqCount` поле для определения длины буфера.
`ioDirID`	На вводе, родительский каталог ID файла или каталога.

Если указанный объект уже имеет комментарий в базе данных, новый комментарий заменяет старое.

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

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

Objective C

@import CoreServices;

Доступность

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

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

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

Выделение хранения для файлов


    
    FSAllocateFork
    FSAllocateFork

(OS X v10.8)

Выделяет площадь на объеме к открытому ветвлению.

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

На уровне POSIX/BSD использовать fcntl с F_PREALLOCATE вместо этого.

Объявление

Objective C

OSErr FSAllocateFork ( FSIORefNum forkRefNum, FSAllocationFlags flags, UInt16 positionMode, SInt64 positionOffset, UInt64 requestCount, UInt64 *actualCount );

Параметры

`forkRefNum`	Ссылочный номер открытого ветвления. Можно получить ссылочный номер ветвления с `FSOpenFork` функция, или с одним из соответствующего параметра блокируют вызовы, `PBOpenForkSync` и `PBOpenForkAsync`.
`flags`	Постоянное указание, как должна быть выделена новая площадь. Посмотрите Флаги Выделения для описания констант, которые можно использовать в этом параметре.
`positionMode`	Постоянное указание основного расположения для запуска выделения. Посмотрите Константы Режима Позиции для получения дополнительной информации о константах, которые можно использовать для указания основного расположения.
`positionOffset`	Смещение от основного расположения запуска выделения.
`requestCount`	Число байтов для выделения.
`actualCount`	По возврату, указателю на число байтов, фактически выделенных файлу. Значение возвратилось в, здесь может быть меньшим, чем число, указанное в `requestCount` параметр, если была уже выделена часть площади. Значение, на которое указывают `actualCount` параметр не отражает дополнительных байтов, которые, возможно, были выделены, потому что площадь выделена с точки зрения фиксированных модулей, таких как блоки выделения, или использование размера глыбы для сокращения фрагментации. `actualCount` если Вы не хотите число выделенных возвращенных байтов, набор, вывод является дополнительным `actualCount` к `NULL`.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

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

Когда ветвление будет закрыто, с помощью, любая выделенная дополнительная площадь, но не используемая будет освобождена FSCloseFork , PBCloseForkSync , или PBCloseForkAsync ; или когда ветвление сбрасывается, с помощью FSFlushFork , PBFlushForkSync , или PBFlushForkAsync.

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

Objective C

@import CoreServices;

Доступность

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

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


    
    PBAllocateForkSync
    PBAllocateForkSync

(OS X v10.8)

Выделяет площадь на объеме к открытому ветвлению.

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

На уровне POSIX/BSD использовать fcntl(2) OS X Developer Tools Manual Page с F_PREALLOCATE вместо этого.

Объявление

Objective C

OSErr PBAllocateForkSync ( FSForkIOParam *paramBlock );

Параметры


      paramBlock

Указатель на ветвление блок параметра I/O. Посмотрите FSForkIOParam для описания FSForkIOParam тип данных.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`forkRefNum`	На вводе, ссылочном номере открытого ветвления. Можно получить ссылочный номер ветвления с `FSOpenFork` функция, или с одним из соответствующего параметра блокируют функции, `PBOpenForkSync` и `PBOpenForkAsync`.
`allocationFlags`	На вводе, постоянном указании, как должна быть выделена новая площадь. Посмотрите Флаги Выделения для описания констант, которые можно использовать в этом поле.
`positionMode`	На вводе, постоянном указании основного расположения в ветвлении для запуска выделения. Посмотрите Константы Режима Позиции для получения дополнительной информации о константах, которые можно использовать для указания основного расположения.
`positionOffset`	На вводе, смещении от основного расположения запуска выделения.
`allocationAmount`	На вводе, числе байтов для выделения. На выводе, числе байтов, фактически выделенных файлу. Если часть площади была уже выделена, число выделенных байтов может быть меньшим, чем требуемая сумма. Значение, возвращенное в этом поле, не отражает дополнительных байтов, которые, возможно, были выделены, потому что площадь выделена с точки зрения фиксированных модулей, таких как блоки выделения, или использование размера глыбы для сокращения фрагментации.

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

Когда ветвление будет закрыто, с помощью, любая выделенная дополнительная площадь, но не используемая будет освобождена FSCloseFork , PBCloseForkSync , или PBCloseForkAsync ; или, когда сброшено, с помощью FSFlushFork , PBFlushForkSync , или PBFlushForkAsync.

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

Objective C

@import CoreServices;

Доступность

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

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


    
    PBAllocateForkAsync
    PBAllocateForkAsync

(OS X v10.8)

Выделяет площадь на объеме к открытому ветвлению.

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

На уровне POSIX/BSD использовать fcntl(2) OS X Developer Tools Manual Page с F_PREALLOCATE вместо этого.

Объявление

Objective C

void PBAllocateForkAsync ( FSForkIOParam *paramBlock );

Параметры


      paramBlock

Указатель на ветвление блок параметра I/O. Посмотрите FSForkIOParam для описания FSForkIOParam тип данных.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции.
`forkRefNum`	На вводе, ссылочном номере открытого ветвления. Можно получить ссылочный номер ветвления с `FSOpenFork` функция, или с одним из соответствующего параметра блокируют вызовы, `PBOpenForkSync` и `PBOpenForkAsync`.
`allocationFlags`	На вводе, постоянном указании, как должна быть выделена новая площадь. Посмотрите Флаги Выделения для описания констант, которые можно использовать в этом поле.
`positionMode`	На вводе, постоянном указании основного расположения в ветвлении для запуска выделения. Посмотрите Константы Режима Позиции для получения дополнительной информации о константах, которые можно использовать для указания основного расположения.
`positionOffset`	На вводе, смещении от основного расположения запуска выделения.
`allocationAmount`	На вводе, числе байтов для выделения. На выводе, числе байтов, фактически выделенных файлу. Если часть площади была уже выделена, число выделенных байтов может быть меньшим, чем требуемая сумма. Значение, возвращенное в этом поле, не отражает дополнительных байтов, которые, возможно, были выделены, потому что площадь выделена с точки зрения фиксированных модулей, таких как блоки выделения, или использование размера глыбы для сокращения фрагментации.

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

Когда ветвление будет закрыто, с помощью, любая выделенная дополнительная площадь, но не используемая будет освобождена FSCloseFork , PBCloseForkSync , или PBCloseForkAsync ; или, когда сброшено, с помощью FSFlushFork , PBFlushForkSync , или PBFlushForkAsync.

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

Objective C

@import CoreServices;

Доступность

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

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


    
    Выделить
    Выделить

(OS X v10.4)

Выделяет дополнительную площадь на объеме к открытому файлу.

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

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

Объявление

Objective C

OSErr Allocate ( FSIORefNum refNum, SInt32 *count );

Параметры

`refNum`	Число ссылки на файл открытого файла.
`count`	На вводе, указателе на число дополнительных байтов для выделения файлу. По возврату, указателю на число байтов, фактически выделенных, окруженных к самому близкому кратному числу размера блока выделения.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Allocate функция добавляет конкретное количество байтов к файлу и устанавливает физический конец файла 1 байту вне последнего выделенного блока. Если нет достаточного вакуума на объеме для удовлетворения запроса выделения, Allocate выделяет остальную часть пространства на объеме и возвратах dskFulErr как его функциональный результат.

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

Файловый менеджер автоматически выделяет блоки файла, если Вы перемещаете логический конец файла мимо физического конца файла, и это автоматически освобождает ненужные блоки от файла при перемещении логического конца файла позиции больше чем один блок выделения перед текущим физическим концом файла. Следовательно, Вы не делаете в общей потребности, которая будет касаться выделения или освобождения блоков файла. Если Вы используете, Однако можно улучшить блочную смежность файла Allocate или AllocContig функция, чтобы предварительно выделить блоки файла. Это является самым полезным, если Вы знаете заранее, как большой файл, вероятно, станет.

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

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

Эта функция не поддерживается всеми файловыми системами; например, объемы, смонтированные файловой системой AppleShare, не поддерживают эту функцию. Для выделения площади для файла на любом объеме используйте SetEOF функция или один из связанного параметра блокирует вызовы, PBSetEOFSync и PBSetEOFAsync.

Для выделения площади для файла вне 2 ГБ используйте FSAllocateFork функция или один из соответствующего параметра блокирует функции, PBAllocateForkSync и PBAllocateForkAsync.

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

В Mac OS 7.5.5 через Mac OS 8.5, если существует недостаточно пространства, оставленного на объеме выделить требуемое число байтов, Allocate функция не возвращает число байтов, фактически выделенных. Ваше приложение не должно полагаться на значение, возвращенное в count параметр.

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

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

Objective C

@import CoreServices;

Доступность

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

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

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


    
    PBAllocateSync
    PBAllocateSync

(OS X v10.4)

Выделяет дополнительную площадь на объеме к открытому файлу.

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

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

Объявление

Objective C

OSErr PBAllocateSync ( ParmBlkPtr paramBlock );

Параметры


      paramBlock

Указатель на IOParam вариант основного блока параметра Файлового менеджера. Посмотрите ParamBlockRec для описания ParamBlockRec тип данных.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioRefNum`	На вводе, числе ссылки на файл для файла, которому можно выделить дополнительные блоки.
`ioReqCount`	На вводе, числе байтов для выделения.
`ioActCount`	На выводе, числе байтов, фактически выделенных, окруженных к самому близкому кратному числу размера блока выделения.

PBAllocateSync функция добавляет ioReqCount байты к указанному файлу и наборам физический конец файла 1 байту вне последнего блока выделяются. Если нет достаточного вакуума на объеме для удовлетворения запроса выделения, PBAllocateSync выделяет остальную часть пространства на объеме и возвратах dskFulErr как его функциональный результат.

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

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

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

В Mac OS 7.5.5 через Mac OS 8.5, если существует недостаточно пространства, оставленного на объеме выделить требуемое число байтов, PBAllocateSync функция не возвращает число байтов, фактически выделенных в ioActCount поле.

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

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

Objective C

@import CoreServices;

Доступность

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

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

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


    
    PBAllocateAsync
    PBAllocateAsync

(OS X v10.4)

Выделяет дополнительную площадь на объеме к открытому файлу.

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

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

Объявление

Objective C

OSErr PBAllocateAsync ( ParmBlkPtr paramBlock );

Параметры


      paramBlock

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции.
`ioRefNum`	На вводе, числе ссылки на файл для файла, которому можно выделить дополнительные блоки.
`ioReqCount`	На вводе, числе байтов для выделения.
`ioActCount`	На выводе, числе байтов, фактически выделенных, окруженных к самому близкому кратному числу размера блока выделения.

PBAllocateAsync функция добавляет ioReqCount байты к указанному файлу и наборам физический конец файла 1 байту вне последнего блока выделяются. Если нет достаточного вакуума на объеме для удовлетворения запроса выделения, PBAllocateAsync выделяет остальную часть пространства на объеме и возвратах dskFulErr как его функциональный результат.

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

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

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

В Mac OS 7.5.5 через Mac OS 8.5, если существует недостаточно пространства, оставленного на объеме выделить требуемое число байтов, PBAllocateAsync функция не возвращает число байтов, фактически выделенных в ioActCount поле.

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

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

Objective C

@import CoreServices;

Доступность

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

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

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


    
    AllocContig
    AllocContig

(OS X v10.4)

Выделяет дополнительную непрерывную площадь на объеме к открытому файлу.

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

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

Объявление

Objective C

OSErr AllocContig ( FSVolumeRefNum refNum, SInt32 *count );

Параметры

`refNum`	Число ссылки на файл открытого файла.
`count`	На вводе, указателе на число дополнительных байтов для выделения файлу; по возврату, указателю на число байтов, выделенных, окруженных к самому близкому кратному числу размера блока выделения.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

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

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

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

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

В Mac OS 7.5.5 через Mac OS 8.5, когда существует недостаточно пространства для выделения требуемого числа байтов, AllocContig не возвращается 0 в count параметр, таким образом, Ваше приложение не может положиться на это значение.

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

Objective C

@import CoreServices;

Доступность

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

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

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


    
    PBAllocContigSync
    PBAllocContigSync

(OS X v10.4)

Выделяет дополнительную непрерывную площадь на объеме к открытому файлу.

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

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

Объявление

Objective C

OSErr PBAllocContigSync ( ParmBlkPtr paramBlock );

Параметры


      paramBlock

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioRefNum`	На вводе, числе ссылки на файл для открытого файла.
`ioReqCount`	На вводе, числе байтов для выделения.
`ioActCount`	На выводе, числе байтов, фактически выделенных, окруженных к самому близкому кратному числу размера блока выделения.

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

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

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

В Mac OS 7.5.5 через Mac OS 8.5, когда существует недостаточно пространства для выделения требуемого числа байтов, PBAllocContigSync не возвращается 0 в ioActCount поле, таким образом, Ваше приложение не может положиться на это значение.

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

Objective C

@import CoreServices;

Доступность

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

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

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


    
    PBAllocContigAsync
    PBAllocContigAsync

(OS X v10.4)

Выделяет дополнительную непрерывную площадь на объеме к открытому файлу.

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

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

Объявление

Objective C

OSErr PBAllocContigAsync ( ParmBlkPtr paramBlock );

Параметры


      paramBlock

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции.
`ioRefNum`	На вводе, числе ссылки на файл для открытого файла.
`ioReqCount`	На вводе, числе байтов для выделения.
`ioActCount`	На выводе, числе байтов, фактически выделенных, окруженных к самому близкому кратному числу размера блока выделения.

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

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

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

В Mac OS 7.5.5 через Mac OS 8.5, когда существует недостаточно пространства для выделения требуемого числа байтов, PBAllocContigAsync не возвращается 0 в ioActCount поле, таким образом, Ваше приложение не может положиться на это значение.

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

Objective C

@import CoreServices;

Доступность

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

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

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

Изменяя полномочия файла, ACLs и владение


    
    FSFileSecuritySetGroup
    FSFileSecuritySetGroup

(OS X v10.8)

Устанавливает группу ID, связанный с данным FSFileSecurityRef объект.

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

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

Объявление

Objective C

OSStatus FSFileSecuritySetGroup ( FSFileSecurityRef fileSec, UInt32 group );

Параметры

`fileSec`	`FSFileSecurityRef` объект.
`group`	Группа UUID для установки.

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

Успех возвратов, если группа был установлен UUID.

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

Objective C

@import CoreServices;

Доступность

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

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


    
    FSFileSecuritySetMode
    FSFileSecuritySetMode

(OS X v10.8)

Устанавливает режим, связанный с данным FSFileSecurityRef объект.

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

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

Объявление

Objective C

OSStatus FSFileSecuritySetMode ( FSFileSecurityRef fileSec, UInt16 mode );

Параметры

`fileSec`	`FSFileSecurityRef` объект.
`mode`	Режим файла связался с `FSFileSecurityRef` объект.

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

Успех возвратов, если был установлен режим.

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

Objective C

@import CoreServices;

Доступность

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

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


    
    FSFileSecuritySetOwner
    FSFileSecuritySetOwner

(OS X v10.8)

Устанавливает владельца ID, связанный с данным FSFileSecurityRef объект.

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

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

Объявление

Objective C

OSStatus FSFileSecuritySetOwner ( FSFileSecurityRef fileSec, UInt32 owner );

Параметры

`fileSec`	`FSFileSecurityRef` объект.
`owner`	Владелец UUID для установки.

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

Успех возвратов, если владелец был установлен UUID.

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

Objective C

@import CoreServices;

Доступность

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

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


    
    FSFileSecuritySetOwnerUUID
    FSFileSecuritySetOwnerUUID

(OS X v10.8)

Устанавливает владельца UUID, связанный с данным FSFileSecurityRef объект.

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

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

Объявление

Objective C

OSStatus FSFileSecuritySetOwnerUUID ( FSFileSecurityRef fileSec, const CFUUIDBytes *owner );

Параметры

`fileSec`	`FSFileSecurityRef` объект.
`owner`	Владелец UUID для установки.

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

Успех возвратов, если владелец был установлен UUID.

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

Objective C

@import CoreServices;

Доступность

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

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


    
    FSFileSecuritySetGroupUUID
    FSFileSecuritySetGroupUUID

(OS X v10.8)

Устанавливает группу UUID, связанный с данным FSFileSecurityRef объект.

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

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

Объявление

Objective C

OSStatus FSFileSecuritySetGroupUUID ( FSFileSecurityRef fileSec, const CFUUIDBytes *group );

Параметры

`fileSec`	`FSFileSecurityRef` объект.
`group`	Группа UUID для установки.

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

Успех возвратов, если группа был установлен UUID.

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

Objective C

@import CoreServices;

Доступность

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

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


    
    FSFileSecuritySetAccessControlList
    FSFileSecuritySetAccessControlList

(OS X v10.8)

Устанавливает список управления доступом (ACL), связанный с данным FSFileSecurityRef объект.

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

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

Объявление

Objective C

OSStatus FSFileSecuritySetAccessControlList ( FSFileSecurityRef fileSec, acl_t accessControlList );

Параметры

`fileSec`	`FSFileSecurityRef` объект.
`accessControlList`	Список управления доступом для установки или `kFSFileSecurityRemoveACL` запрашивать удаление ACL от данного `FSFileSecurityRef` объект, или `NULL` сбрасывать свойство.

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

Успех возвратов, если был установлен ACL.

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

Objective C

@import CoreServices;

Доступность

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

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

Заключительные файлы


    
    FSCloseFork
    FSCloseFork

(OS X v10.8)

Закрывает открытое ветвление.

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

На уровне POSIX/BSD использовать close(2) OS X Developer Tools Manual Page вместо этого. Для закрытия ветви данных на уровне Foundation использовать NSFileHandle APIs вместо этого.

Объявление

Objective C

OSErr FSCloseFork ( FSIORefNum forkRefNum );

Параметры


      forkRefNum

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

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

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

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

Objective C

@import CoreServices;

Доступность

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

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


    
    PBCloseForkSync
    PBCloseForkSync

(OS X v10.8)

Закрывает открытое ветвление.

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

Объявление

Objective C

OSErr PBCloseForkSync ( FSForkIOParam *paramBlock );

Параметры


      paramBlock

Указатель на ветвление блок параметра I/O. Посмотрите FSForkIOParam для описания FSForkIOParam.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующее поле блока параметра:


      forkRefNum

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

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

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

Objective C

@import CoreServices;

Доступность

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

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


    
    PBCloseForkAsync
    PBCloseForkAsync

(OS X v10.8)

Закрывает открытое ветвление.

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

Объявление

Objective C

void PBCloseForkAsync ( FSForkIOParam *paramBlock );

Параметры


      paramBlock

Указатель на ветвление блок параметра I/O. Посмотрите FSForkIOParam для описания FSForkIOParam.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции.
`forkRefNum`	На вводе, ссылочном номере ветвления для закрытия. После вызова к этой функции ссылочный номер в этом параметре недопустим.

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

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

Objective C

@import CoreServices;

Доступность

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

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

FSClose FSClose (OS X v10.4)

Закрывает открытый файл.

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

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

Объявление

Objective C

OSErr FSClose ( FSIORefNum refNum );

Параметры

refNum

Число ссылки на файл открытого файла.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

FSClose функция удаляет путь доступа для указанного файла и пишет содержание буфера объема к объему.

FSClose вызовы функции PBFlushFileSync функционируйте внутренне для записи байтов файла на объем. Чтобы гарантировать, что каталогизационное описание файла обновляется, необходимо вызвать FlushVol после вызова FSClose.

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

Удостоверьтесь, что Вы не вызываете FSClose с числом ссылки на файл уже закрытого файла. Попытка закрыть тот же файл дважды может привести к потере данных по объему.

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

Objective C

@import CoreServices;

Доступность

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


    
    PBCloseAsync
    PBCloseAsync

(OS X v10.5)

Закрывает открытый файл.

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

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

Объявление

Objective C

OSErr PBCloseAsync ( ParmBlkPtr paramBlock );

Параметры


      paramBlock

Указатель на основной блок параметра Файлового менеджера.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения.
`ioResult`	На выводе, коде результата функции.
`ioRefNum`	На вводе, числе ссылки на файл к файлу для закрытия.

PBCloseAsync функционируйте пишет содержание буфера пути доступа, указанного ioRefNum поле к объему и удаляет путь доступа.

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

Некоторая информация, хранившая на объеме, не будет обновлена до PBFlushVolAsync вызывается.

Не вызывать PBCloseAsync с числом ссылки на файл уже закрытого файла. Попытка закрыть тот же файл дважды может привести к потере данных по объему.

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

Objective C

@import CoreServices;

Доступность

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

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

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

PBCloseSync PBCloseSync (OS X v10.5)

Закрывает открытый файл.

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

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

Объявление

Objective C

OSErr PBCloseSync ( ParmBlkPtr paramBlock );

Параметры

paramBlock

Указатель на основной блок параметра Файлового менеджера.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующее поле блока параметра:

ioRefNum

На вводе, числе ссылки на файл к файлу для закрытия.

PBCloseSync функционируйте пишет содержание буфера пути доступа, указанного ioRefNum поле к объему и удаляет путь доступа.

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

Некоторая информация, хранившая на объеме, не будет обновлена до PBFlushVolSync вызывается.

Не вызывать PBCloseSync с числом ссылки на файл уже закрытого файла. Попытка закрыть тот же файл дважды может привести к потере данных по объему.

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

Objective C

@import CoreServices;

Доступность

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

Сравнение ссылок файловой системы


    
    FSCompareFSRefs
    FSCompareFSRefs

(OS X v10.8)

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

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

Использовать NSURL или CFURL APIs вместо этого. Для сравнения двух файлов URLs, чтобы видеть, есть ли у них тот же путь файловой системы или если пути соединяются с тем же inode в той же файловой системе используйте NSURLFileResourceIdentifierKey или kCFURLFileResourceIdentifierKey свойства.

Объявление

Objective C

OSErr FSCompareFSRefs ( const FSRef *ref1, const FSRef *ref2 );

Параметры

`ref1`	Указатель на первое `FSRef` выдерживать сравнение. Для описания `FSRef` тип данных, посмотрите `FSRef`.
`ref2`	Указатель на второе `FSRef` выдерживать сравнение.

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

Код результата. Посмотрите Коды Результата Файлового менеджера. Если два FSRef структуры относятся к тому же файлу или каталогу, тогда noErr возвращается. Если они обращаются к объектам на различных объемах, то diffVolErr возвращается. Если они обращаются к различным файлам или каталогам на том же объеме, то errFSRefsDifferent возвращается. Эта функция может возвратить другие ошибки, включая nsvErr, fnfErr, dirNFErr, и volOffLinErr.

Обсуждение

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

Некоторые форматы объема могут быть в состоянии сказать это два FSRef структуры относились бы к двум различным файлам или каталогам, не имея необходимость фактически находить те объекты. В этом случае формат объема может возвратиться errFSRefsDifferent даже если больше не существуют один или оба объекта. Точно так же, если FSRef структуры для объектов на различных объемах, Файловый менеджер возвратится diffVolErr даже если больше не монтируются один или оба объема.

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

Objective C

@import CoreServices;

Доступность

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

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


    
    PBCompareFSRefsSync
    PBCompareFSRefsSync

(OS X v10.8)

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

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

Объявление

Objective C

OSErr PBCompareFSRefsSync ( FSRefParam *paramBlock );

Параметры


      paramBlock

Указатель на блок параметра ссылки файловой системы. Посмотрите FSRefParam для описания FSRefParam тип данных.

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

Обсуждение

Соответствующие поля блока параметра:

`ref`	На вводе, указателе на первое `FSRef` выдерживать сравнение. Посмотрите `FSRef` для описания `FSRef` тип данных.
`parentRef`	На вводе, указателе на второе `FSRef` выдерживать сравнение.

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

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

Objective C

@import CoreServices;

Доступность

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

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


    
    PBCompareFSRefsAsync
    PBCompareFSRefsAsync

(OS X v10.8)

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

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

Объявление

Objective C

void PBCompareFSRefsAsync ( FSRefParam *paramBlock );

Параметры


      paramBlock

Указатель на блок параметра ссылки файловой системы. Посмотрите FSRefParam для описания FSRefParam тип данных.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения, посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции. Если два `FSRef` структуры относятся к тому же файлу или каталогу, тогда `noErr` возвращается. Если они обращаются к объектам на различных объемах, то `diffVolErr` возвращается. Если они обращаются к различным файлам или каталогам на том же объеме, то `errFSRefsDifferent` возвращается. Этот вызов может возвратить другие ошибки, включая `nsvErr`, `fnfErr`, `dirNFErr`, и `volOffLinErr`. См., “что файловый менеджер заканчивается коды”.
`ref`	На вводе, указателе на первое `FSRef` выдерживать сравнение. Посмотрите `FSRef` для описания `FSRef` тип данных.
`parentRef`	На вводе, указателе на второе `FSRef` выдерживать сравнение.

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

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

Objective C

@import CoreServices;

Доступность

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

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

Управление доступом каталога


    
    PBHGetDirAccessSync
    PBHGetDirAccessSync

(OS X v10.5)

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

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

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

Объявление

Objective C

OSErr PBHGetDirAccessSync ( HParmBlkPtr paramBlock );

Параметры


      paramBlock

Указатель на AccessParam вариант блока параметра HFS. Посмотрите HParamBlockRec для описания HParamBlockRec тип данных.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioNamePtr`	На вводе, указателе на путь для каталога или файла.
`ioVRefNum`	На вводе, спецификации объема для объема, содержащего каталог или файл. Это поле может содержать ссылочный номер объема, число диска, или 0 для объема по умолчанию.
`ioACOwnerID`	На выводе, идентификаторе пользователя для владельца каталога или файла.
`ioACGroupID`	На выводе, основная группа ID каталога или файла.
`ioACAccess`	На выводе, правах доступа для каталога или файла. Посмотрите Константы Права доступа Файла и Папки для получения дополнительной информации об этих правах доступа.
`ioDirID`	На вводе, каталоге ID.

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

Objective C

@import CoreServices;

Доступность

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

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

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


    
    PBHGetDirAccessAsync
    PBHGetDirAccessAsync

(OS X v10.5)

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

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

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

Объявление

Objective C

OSErr PBHGetDirAccessAsync ( HParmBlkPtr paramBlock );

Параметры


      paramBlock

Указатель на AccessParam вариант блока параметра HFS. Посмотрите HParamBlockRec для описания HParamBlockRec тип данных.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на функцию завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции.
`ioNamePtr`	На вводе, указателе на путь для каталога или файла.
`ioVRefNum`	На вводе, спецификации объема для объема, содержащего каталог или файл. Это поле может содержать ссылочный номер объема, число диска, или 0 для объема по умолчанию.
`ioACOwnerID`	На выводе, идентификаторе пользователя для владельца каталога или файла.
`ioACGroupID`	На выводе, основная группа ID каталога или файла.
`ioACAccess`	На выводе, правах доступа для каталога или файла. Посмотрите Константы Права доступа Файла и Папки для получения дополнительной информации об этих правах доступа.
`ioDirID`	На вводе, каталоге ID.

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

Objective C

@import CoreServices;

Доступность

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

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

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


    
    PBHSetDirAccessSync
    PBHSetDirAccessSync

(OS X v10.5)

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

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

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

Объявление

Objective C

OSErr PBHSetDirAccessSync ( HParmBlkPtr paramBlock );

Параметры


      paramBlock

Указатель на AccessParam вариант блока параметра HFS. Посмотрите HParamBlockRec для описания HParamBlockRec тип данных.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioNamePtr`	На вводе, указателе на путь.
`ioVRefNum`	На вводе, спецификации объема для объема, содержащего каталог. Это поле может содержать ссылочный номер объема, число диска, или 0 для объема по умолчанию.
`ioACOwnerID`	На вводе, владелец ID.
`ioACGroupID`	На вводе, группа ID.
`ioACAccess`	На вводе, правах доступа каталога. Вы не можете установить биты прав владельца или пользователя `ioACAccess` поле непосредственно; при попытке сделать это, `PBHSetDirAccessSync` возвращает код результата `paramErr`. Только пустые права доступа могут быть установлены для каталога с помощью этой функции. Посмотрите Константы Права доступа Файла и Папки для получения дополнительной информации о правах доступа каталога.
`ioDirID`	На вводе, каталоге ID.

Для изменения владельца или группы необходимо установить ioACOwnerID или ioACGroupID поле к надлежащему ID. Необходимо быть владельцем каталога для изменения владельца или группы ID. Гость на сервере может управлять полномочиями любого каталога, принадлежавшего гостю.

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

Objective C

@import CoreServices;

Доступность

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

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

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


    
    PBHSetDirAccessAsync
    PBHSetDirAccessAsync

(OS X v10.5)

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

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

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

Объявление

Objective C

OSErr PBHSetDirAccessAsync ( HParmBlkPtr paramBlock );

Параметры


      paramBlock

Указатель на AccessParam вариант блока параметра HFS. Посмотрите HParamBlockRec для описания HParamBlockRec тип данных.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на функцию завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции.
`ioNamePtr`	На вводе, указателе на путь.
`ioVRefNum`	На вводе, спецификации объема для объема, содержащего каталог. Это поле может содержать ссылочный номер объема, число диска, или 0 для объема по умолчанию.
`ioACOwnerID`	На вводе, владелец ID.
`ioACGroupID`	На вводе, группа ID.
`ioACAccess`	На вводе, правах доступа каталога. Вы не можете установить биты прав владельца или пользователя `ioACAccess` поле непосредственно; при попытке сделать это, `PBHSetDirAccessAsync` возвращает код результата `paramErr`. Только пустые права доступа могут быть установлены для каталога с помощью этой функции. Посмотрите Константы Права доступа Файла и Папки для получения дополнительной информации о правах доступа каталога.
`ioDirID`	На вводе, каталоге ID.

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

Objective C

@import CoreServices;

Доступность

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

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

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

Управление доступом входа в систему


    
    PBHGetLogInInfoAsync
    PBHGetLogInInfoAsync

(OS X v10.4)

Решает, что метод входа в систему раньше входил в систему определенного совместно используемого тома.

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

Нет никакой заменяющей функции.

Объявление

Objective C

OSErr PBHGetLogInInfoAsync ( HParmBlkPtr paramBlock );

Параметры


      paramBlock

Указатель на ObjParam вариант блока параметра HFS. Посмотрите HParamBlockRec для описания HParamBlockRec тип данных.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на функцию завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции.
`ioNamePtr`	На вводе, указателе на путь
`ioVRefNum`	На вводе, спецификации объема для совместно используемого тома. Это поле может содержать ссылочный номер объема, число диска, или 0 для объема по умолчанию.
`ioObjType`	На выводе, типе метода входа в систему. Посмотрите Константы Метода аутентификации для распознанных значений. Значения в диапазоне 7–127 резервируются для будущего использования Apple Computer, Inc. Значения в диапазоне 128–255 доступны Вашему приложению как определяемые пользователем значения.
`ioObjNamePtr`	На выводе указатель на имя пользователя раньше устанавливал сеанс. Имя зарегистрированного пользователя возвращается как строка Паскаля. Максимальный размер имени пользователя является 31 символом.

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

Эта функция не реализована в OS X.

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

Objective C

@import CoreServices;

Доступность

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

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

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


    
    PBHMapIDSync
    PBHMapIDSync

(OS X v10.5)

Определяет имя пользователя или группы, данной пользователя или группу ID.

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

Нет никакой заменяющей функции.

Объявление

Objective C

OSErr PBHMapIDSync ( HParmBlkPtr paramBlock );

Параметры


      paramBlock

Указатель на ObjParam вариант блока параметра HFS. Посмотрите HParamBlockRec для описания HParamBlockRec тип данных.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioNamePtr`	На вводе, указателе на путь.
`ioVRefNum`	На вводе, спецификации объема.
`ioObjType`	На вводе отображающаяся функция кодирует свое значение, 1, если Вы отображаете идентификатор пользователя на имя пользователя или 2 при отображении группы ID на название группы. Посмотрите Отображающиеся Кодовые константы для получения дополнительной информации о значениях, которые можно использовать в этом поле.
`ioObjNamePtr`	На выводе, указателе на пользователя или название группы; максимальный размер имени является 31 символом (предшествовавший байтом длины).
`ioObjID`	На вводе, пользователе или группе ID, который будет отображен. AppleShare использует значение 0 для выражения Любого Пользователя.

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

Посмотрите функции BSD getpwnam и getpwuid, которые соответствуют этой функции на концептуальном уровне.

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

Objective C

@import CoreServices;

Доступность

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

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

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


    
    PBHMapIDAsync
    PBHMapIDAsync

(OS X v10.5)

Определяет имя пользователя или группы, данной пользователя или группу ID.

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

Нет никакой заменяющей функции.

Объявление

Objective C

OSErr PBHMapIDAsync ( HParmBlkPtr paramBlock );

Параметры


      paramBlock

Указатель на ObjParam вариант блока параметра HFS. Посмотрите HParamBlockRec для описания HParamBlockRec тип данных.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции.
`ioNamePtr`	На вводе, указателе на путь.
`ioVRefNum`	На вводе, спецификации объема.
`ioObjType`	На вводе отображающаяся функция кодирует свое значение, 1, если Вы отображаете идентификатор пользователя на имя пользователя или 2 при отображении группы ID на название группы. Посмотрите Отображающиеся Кодовые константы для получения дополнительной информации о значениях, которые можно использовать в этом поле.
`ioObjNamePtr`	На выводе, указателе на пользователя или название группы; максимальный размер имени является 31 символом (предшествовавший байтом длины).
`ioObjID`	На вводе, пользователе или группе ID, который будет отображен. AppleShare использует значение 0 для выражения Любого Пользователя.

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

Посмотрите функции BSD getpwnam и getpwuid, которые соответствуют этой функции на концептуальном уровне.

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

Objective C

@import CoreServices;

Доступность

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

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

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


    
    PBHMapNameSync
    PBHMapNameSync

(OS X v10.5)

Определяет идентификатор пользователя или группу ID от пользователя или названия группы.

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

Нет никакой заменяющей функции.

Объявление

Objective C

OSErr PBHMapNameSync ( HParmBlkPtr paramBlock );

Параметры


      paramBlock

Указатель на ObjParam вариант блока параметра HFS. Посмотрите HParamBlockRec для описания HParamBlockRec тип данных.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioNamePtr`	На вводе, указателе на путь.
`ioVRefNum`	На вводе, спецификации объема.
`ioObjType`	На вводе отображающаяся функция кодирует свое значение, 3, если Вы отображаете имя пользователя на идентификатор пользователя или 4 при отображении названия группы на группу ID. Посмотрите Отображающиеся Кодовые константы для получения дополнительной информации о значениях, которые можно использовать в этом поле.
`ioObjNamePtr`	На вводе, указателе на пользователя или название группы. Максимальный размер имени является 31 символом. Если `NULL` передается, ID возвратился, всегда 0.
`ioObjID`	На выводе, отображенном пользователе или группе ID.

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

Посмотрите функции BSD getpwnam и getpwuid, которые соответствуют этой функции на концептуальном уровне.

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

Objective C

@import CoreServices;

Доступность

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

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

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


    
    PBHMapNameAsync
    PBHMapNameAsync

(OS X v10.5)

Определяет идентификатор пользователя или группу ID от пользователя или названия группы.

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

Нет никакой заменяющей функции.

Объявление

Objective C

OSErr PBHMapNameAsync ( HParmBlkPtr paramBlock );

Параметры


      paramBlock

Указатель на ObjParam вариант блока параметра HFS. Посмотрите HParamBlockRec для описания HParamBlockRec тип данных.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции.
`ioNamePtr`	На вводе, указателе на путь.
`ioVRefNum`	На вводе, спецификации объема.
`ioObjType`	На вводе отображающаяся функция кодирует свое значение, 3, если Вы отображаете имя пользователя на идентификатор пользователя или 4 при отображении названия группы на группу ID. Посмотрите Отображающиеся Кодовые константы для получения дополнительной информации о значениях, которые можно использовать в этом поле.
`ioObjNamePtr`	На вводе, указателе на пользователя или название группы. Максимальный размер имени является 31 символом. Если `NULL` передается, ID возвратился, всегда 0.
`ioObjID`	На выводе, отображенном пользователе или группе ID.

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

Посмотрите функции BSD getpwnam и getpwuid, которые соответствуют этой функции на концептуальном уровне.

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

Objective C

@import CoreServices;

Доступность

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

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

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

Преобразование между путями и структурами FSRef


    
    FSRefMakePath
    FSRefMakePath

(OS X v10.8)

Преобразовывает FSRef структура в путь стиля POSIX.

Объявление

Objective C

OSStatus FSRefMakePath ( const FSRef *ref, UInt8 *path, UInt32 pathBufferSize );

Параметры

`ref`	Указатель на `FSRef` структура для преобразования.
`path`	Указатель на символьный буфер выделяется вызывающей стороной. На выводе буфер содержит струну до UTF-8, указывающую абсолютный путь к объекту, именуемому `ref` параметр. Файловый менеджер использует `maxPathSize` параметр для проверки это не превышает буфер.
`maxPathSize`	Максимальное количество байтов для копирования в буфер.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

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

Objective C

@import CoreServices;

Доступность

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

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


    
    FSPathMakeRef
    FSPathMakeRef

(OS X v10.8)

Преобразовывает путь стиля POSIX в FSRef структура.

Объявление

Objective C

OSStatus FSPathMakeRef ( const UInt8 *path, FSRef *ref, Boolean *isDirectory );

Параметры

`path`	Струна до UTF-8, содержащая путь для преобразования.
`ref`	Указатель на `FSRef` структура выделяется вызывающей стороной. На выводе, `FSRef` структура относится к объекту, расположение которого указано `path` параметр.
`isDirectory`	Указатель на Логическую переменную выделяется вызывающей стороной. На выводе, `true` указывает, что объект является каталогом. Этот параметр является дополнительным и может быть `NULL`.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

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

Objective C

@import CoreServices;

Доступность

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

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


    
    FSPathMakeRefWithOptions
    FSPathMakeRefWithOptions

(OS X v10.8)

Преобразовывает путь стиля POSIX в FSRef структура с опциями.

Объявление

Objective C

OSStatus FSPathMakeRefWithOptions ( const UInt8 *path, OptionBits options, FSRef *ref, Boolean *isDirectory );

Параметры

`path`	Струна до UTF-8, содержащая путь для преобразования.
`options`	Один или более флагов преобразования. Посмотрите Опции Преобразования Пути.
`ref`	Указатель на `FSRef` структура выделяется вызывающей стороной. На выводе, `FSRef` структура относится к объекту, расположение которого указано `path` параметр. Если объект является символьной ссылкой, `options` параметр определяет ли `FSRef` структура относится к самой ссылке или к связанному объекту.
`isDirectory`	Указатель на Логическую переменную выделяется вызывающей стороной. На выводе, `true` указывает, что объект является каталогом. Этот параметр является дополнительным и может быть `NULL`.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

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

Objective C

@import CoreServices;

Доступность

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

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

Копирование и движущиеся файлы

PBFSCopyFileSync PBFSCopyFileSync (OS X v10.8)

Копирует файл и дополнительно переименовывает его.

Объявление

Objective C

OSStatus PBFSCopyFileSync ( FSRefParamPtr paramBlock );

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

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.8.
PBFSCopyFileAsync PBFSCopyFileAsync (OS X v10.8)

Копирует файл и дополнительно переименовывает его.

Объявление

Objective C

OSStatus PBFSCopyFileAsync ( FSRefParamPtr paramBlock );

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

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.8.


    
    PBHCopyFileSync
    PBHCopyFileSync

(OS X v10.5)

Копирует файл и дополнительно переименовывает его.

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

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

Объявление

Objective C

OSErr PBHCopyFileSync ( HParmBlkPtr paramBlock );

Параметры


      paramBlock

Указатель на a CopyParam вариант блока параметра HFS. Посмотрите HParamBlockRec для описания HParamBlockRec тип данных.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioNamePtr`	На вводе, указателе на имя исходного файла.
`ioVRefNum`	На вводе, ссылочном номере объема или числе диска для объема, содержащего исходный файл. Передайте 0 для объема по умолчанию.
`ioDstVRefNum`	На вводе, ссылочном номере или числе диска целевого объема. Передайте 0 для объема по умолчанию.
`ioNewName`	На вводе, указателе на частичный путь для целевого каталога. Если `ioNewName` `NULL`, целевой каталог является каталогом, указывающим ID в `ioNewDirID` поле.
`ioCopyName`	На вводе, указателе на новое имя файла. Строка, на которую указывает это поле, должна быть именем файла, не частичным путем. Если Вы не хотите переименовывать файл, передачу `NULL` в этом поле.
`ioNewDirID`	На вводе, если `ioNewName` поле `NULL`, каталог ID целевого каталога. Если `ioNewName` не `NULL`, родительский каталог ID целевого каталога.
`ioDirID`	На вводе, каталоге ID исходного каталога.

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

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

Это - дополнительное требование файловых серверов AppleShare. Ваше приложение должно исследовать информацию, возвращенную PBHGetVolParmsSync функция, чтобы видеть, поддерживает ли объем PBHCopyFileSync. Если bHasCopyFile бит установлен в vMAttrib поле GetVolParmsInfoBuffer структура, тогда поддержки объема PBHCopyFileSync.

Для файловых серверов AppleShare источник и целевые пути должны указать тот же файловый сервер; однако, блок параметра может указать другой источник и целевые объемы на том файловом сервере. Полезный способ сказать, находятся ли два объема файлового сервера на том же файловом сервере, состоит в том, чтобы вызвать PBHGetVolParmsSync функция для каждого объема и выдерживает сравнение, адреса сервера возвратились. Сервер открывается, исходные файлы с читали/отклоняли, и целевые файлы с разрешением записи с пишут/отклоняют чтение и с разрешением записи.

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

Objective C

@import CoreServices;

Доступность

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

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

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


    
    PBHCopyFileAsync
    PBHCopyFileAsync

(OS X v10.5)

Копирует файл и дополнительно переименовывает его.

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

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

Объявление

Objective C

OSErr PBHCopyFileAsync ( HParmBlkPtr paramBlock );

Параметры


      paramBlock

Указатель на a CopyParam вариант блока параметра HFS. Посмотрите HParamBlockRec для описания HParamBlockRec тип данных.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции.
`ioNamePtr`	На вводе, указателе на имя исходного файла.
`ioVRefNum`	На вводе, ссылочном номере объема или числе диска для объема, содержащего исходный файл. Передайте 0 для объема по умолчанию.
`ioDstVRefNum`	На вводе, ссылочном номере или числе диска целевого объема. Передайте 0 для объема по умолчанию.
`ioNewName`	На вводе, указателе на частичный путь для целевого каталога. Если `ioNewName` `NULL`, целевой каталог является каталогом, указывающим ID в `ioNewDirID` поле.
`ioCopyName`	На вводе, указателе на новое имя файла. Строка, на которую указывает это поле, должна быть именем файла, не частичным путем. Если Вы не хотите переименовывать файл, передачу `NULL` в этом поле.
`ioNewDirID`	На вводе, если `ioNewName` поле `NULL`, каталог ID целевого каталога. Если `ioNewName` не `NULL`, родительский каталог ID целевого каталога.
`ioDirID`	На вводе, каталоге ID исходного каталога.

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

Это - дополнительное требование файловых серверов AppleShare. Ваше приложение должно исследовать информацию, возвращенную PBHGetVolParmsAsync функция, чтобы видеть, поддерживает ли объем PBHCopyFileAsync. Если bHasCopyFile бит установлен в vMAttrib поле GetVolParmsInfoBuffer структура, тогда поддержки объема PBHCopyFileAsync.

Для файловых серверов AppleShare источник и целевые пути должны указать тот же файловый сервер; однако, блок параметра может указать другой источник и целевые объемы на том файловом сервере. Полезный способ сказать, находятся ли два объема файлового сервера на том же файловом сервере, состоит в том, чтобы вызвать PBHGetVolParmsAsync функция для каждого объема и выдерживает сравнение, адреса сервера возвратились. Сервер открывается, исходные файлы с читали/отклоняли, и целевые файлы с разрешением записи с пишут/отклоняют чтение и с разрешением записи.

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

Objective C

@import CoreServices;

Доступность

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

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

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


    
    PBHMoveRenameSync
    PBHMoveRenameSync

(OS X v10.4)

Перемещает файл или каталог и дополнительно переименовывает его.

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

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

Объявление

Objective C

OSErr PBHMoveRenameSync ( HParmBlkPtr paramBlock );

Параметры


      paramBlock

Указатель на a CopyParam вариант блока параметра HFS. Посмотрите HParamBlockRec для описания HParamBlockRec тип данных.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

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

Соответствующие поля блока параметра:

`ioNamePtr`	На вводе, указателе на путь для исходного файла или каталога.
`ioVRefNum`	На вводе, ссылочном номере объема или числе диска для объема, содержащего исходный файл или каталог. Передайте 0 для объема по умолчанию.
`ioNewName`	На вводе, указателе на целевой путь. Если `ioNewName` `NULL`, целевой каталог является каталогом, указывающим ID в `ioNewDirID` поле. Если `ioNewName` не `NULL`, целевой каталог является каталогом, указывающим на частичный путь `ioNewName` в каталоге, имеющем ID `ioNewDirID` на указанном объеме.
`ioCopyName`	На вводе, указателе на новое имя файла. Строка, на которую указывает это поле, должна быть именем файла, не частичным путем. Если Вы не хотите переименовывать файл, передачу `NULL` в этом поле.
`ioNewDirID`	На вводе, если `ioNewName` поле `NULL`, каталог ID целевого каталога. Если `ioNewName` не `NULL`, родительский каталог ID целевого каталога.
`ioDirID`	На вводе, каталоге ID исходного каталога.

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

Эта функция не реализована в OS X.

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

Objective C

@import CoreServices;

Доступность

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

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

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


    
    PBHMoveRenameAsync
    PBHMoveRenameAsync

(OS X v10.4)

Перемещает файл или каталог и дополнительно переименовывает его.

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

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

Объявление

Objective C

OSErr PBHMoveRenameAsync ( HParmBlkPtr paramBlock );

Параметры


      paramBlock

Указатель на a CopyParam вариант блока параметра HFS. Посмотрите HParamBlockRec для описания HParamBlockRec тип данных.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

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

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции.
`ioNamePtr`	На вводе, указателе на путь для исходного файла или каталога.
`ioVRefNum`	На вводе, ссылочном номере объема или числе диска для объема, содержащего исходный файл или каталог. Передайте 0 для объема по умолчанию.
`ioNewName`	На вводе, указателе на целевой путь. Если `ioNewName` `NULL`, целевой каталог является каталогом, указывающим ID в `ioNewDirID` поле. Если `ioNewName` не `NULL`, целевой каталог является каталогом, указывающим на частичный путь `ioNewName` в каталоге, имеющем ID `ioNewDirID` на указанном объеме.
`ioCopyName`	На вводе, указателе на новое имя файла. Строка, на которую указывает это поле, должна быть именем файла, не частичным путем. Если Вы не хотите переименовывать файл, передачу `NULL` в этом поле.
`ioNewDirID`	На вводе, если `ioNewName` поле `NULL`, каталог ID целевого каталога. Если `ioNewName` не `NULL`, родительский каталог ID целевого каталога.
`ioDirID`	На вводе, каталоге ID исходного каталога.

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

Эта функция не реализована в OS X.

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

Objective C

@import CoreServices;

Доступность

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

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

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

Копирование и перемещение объектов Используя асинхронные высокоуровневые операции файла


    
    FSFileOperationCreate
    FSFileOperationCreate

(OS X v10.8)

Создает объект, представляющий асинхронную работу файла.

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

На уровне Foundation использовать copyItemAtURL:toURL:error: вместо этого. На уровне POSIX/BSD использовать copyfile(3) OS X Developer Tools Manual Page вместо этого.

Объявление

Objective C

FSFileOperationRef FSFileOperationCreate ( CFAllocatorRef alloc );

Параметры


      alloc

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

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

Новый объект FSFileOperation, или NULL если не мог бы быть создан объект. Когда Вам больше не нужен объект, необходимо выпустить его путем вызова CFRelease.

Обсуждение

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

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

Objective C

@import CoreServices;

Доступность

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

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

FSFileOperationCancel FSFileOperationCancel (OS X v10.8)

Отменяет асинхронную работу файла.

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

На уровне Foundation использовать copyItemAtURL:toURL:error: вместо этого. На уровне POSIX/BSD использовать copyfile(3) OS X Developer Tools Manual Page вместо этого.

Объявление

Objective C

OSStatus FSFileOperationCancel ( FSFileOperationRef fileOp );

Параметры

fileOp

Работа файла для отмены.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

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

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

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.4 и позже.
Осуждаемый в OS X v10.8.
FSFileOperationGetTypeID FSFileOperationGetTypeID (OS X v10.8)

Возвращает Базовый идентификатор типа Основы для FSFileOperation непрозрачный тип.

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

На уровне Foundation использовать copyItemAtURL:toURL:error: вместо этого. На уровне POSIX/BSD использовать copyfile(3) OS X Developer Tools Manual Page вместо этого.

Объявление

Objective C

CFTypeID FSFileOperationGetTypeID ( void );

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

Идентификатор типа для FSFileOperation непрозрачный тип. Для получения информации об этом типе посмотрите FSFileOperationRef.

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

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.4 и позже.
Осуждаемый в OS X v10.8.


    
    FSFileOperationScheduleWithRunLoop
    FSFileOperationScheduleWithRunLoop

(OS X v10.8)

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

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

Объявление

Objective C

OSStatus FSFileOperationScheduleWithRunLoop ( FSFileOperationRef fileOp, CFRunLoopRef runLoop, CFStringRef runLoopMode );

Параметры

`fileOp`	Работа файла для планирования.
`runLoop`	Цикл выполнения, в котором можно запланировать работу. Для получения информации о Базовой Основе выполните циклы, посмотрите Циклы Выполнения.
`runLoopMode`	Режим цикла выполнения, в котором можно запланировать работу. В большинстве случаев можно указать `kCFRunLoopCommonModes`.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

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

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

Objective C

@import CoreServices;

Доступность

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

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


    
    FSFileOperationUnscheduleFromRunLoop
    FSFileOperationUnscheduleFromRunLoop

(OS X v10.8)

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

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

Объявление

Objective C

OSStatus FSFileOperationUnscheduleFromRunLoop ( FSFileOperationRef fileOp, CFRunLoopRef runLoop, CFStringRef runLoopMode );

Параметры

`fileOp`	Работа файла, чтобы не запланировать.
`runLoop`	Цикл выполнения, на который можно не запланировать работу.
`runLoopMode`	Режим цикла выполнения, в котором можно не запланировать работу.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

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

Objective C

@import CoreServices;

Доступность

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

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


    
    FSCopyObjectAsync
    FSCopyObjectAsync

(OS X v10.8)

Запускает асинхронную работу файла для копирования исходного объекта в целевой каталог.

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

Объявление

Objective C

OSStatus FSCopyObjectAsync ( FSFileOperationRef fileOp, const FSRef *source, const FSRef *destDir, CFStringRef destName, OptionBits flags, FSFileOperationStatusProcPtr callback, CFTimeInterval statusChangeInterval, FSFileOperationClientContext *clientContext );

Параметры

`fileOp`	Объект операции файла Вы создали для этой работы копии.
`source`	Указатель на исходный объект для копирования. Объект может быть файлом или каталогом.
`destDir`	Указатель на целевой каталог.
`destName`	Имя для нового объекта в целевом каталоге. Передача `NULL` использовать имя исходного объекта.
`flags`	Один или более флагов опции работы файла. Посмотрите Опции Работы Файла.
`callback`	Функция обратного вызова для получения обновлений статуса как работы файла продолжается. Для получения дополнительной информации посмотрите Обратные вызовы Работы Файла. Этот параметр является дополнительным; передача `NULL` если Вы не должны предоставлять обратный вызов состояния.
`statusChangeInterval`	Минимальное время в секундах между обратными вызовами в одноступенчатой из работы.
`clientContext`	Определяемые пользователем данные для соединения с этой работой. Для получения дополнительной информации посмотрите `FSFileOperationClientContext`. Этот параметр является дополнительным; передача `NULL` если Вы не должны предоставлять клиентский контекст.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

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

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

Objective C

@import CoreServices;

Доступность

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

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


    
    FSMoveObjectAsync
    FSMoveObjectAsync

(OS X v10.8)

Запускает асинхронную работу файла для перемещения исходного объекта в целевой каталог.

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

На уровне Foundation использовать moveItemAtURL:toURL:error: вместо этого. На уровне POSIX/BSD использовать rename(2) OS X Developer Tools Manual Page вместо этого.

Объявление

Objective C

OSStatus FSMoveObjectAsync ( FSFileOperationRef fileOp, const FSRef *source, const FSRef *destDir, CFStringRef destName, OptionBits flags, FSFileOperationStatusProcPtr callback, CFTimeInterval statusChangeInterval, FSFileOperationClientContext *clientContext );

Параметры

`fileOp`	Объект операции файла Вы создали для этой операции пересылки.
`source`	Указатель на исходный объект для перемещения. Объект может быть файлом или каталогом.
`destDir`	Указатель на целевой каталог. Если целевой каталог не находится на том же объеме как исходный объект, исходный объект скопирован и затем удален.
`destName`	Имя для нового объекта в целевом каталоге. Передача `NULL` использовать имя исходного объекта.
`flags`	Один или более флагов опции работы файла. Посмотрите Опции Работы Файла. Если Вы указываете `kFSFileOperationDoNotMoveAcrossVolumes` флаг и целевой каталог не находятся на том же объеме как исходный объект, эта функция ничего не делает и возвращает ошибку.
`callback`	Функция обратного вызова для получения обновлений статуса как работы файла продолжается. Для получения дополнительной информации посмотрите Обратные вызовы Работы Файла. Этот параметр является дополнительным; передача `NULL` если Вы не должны предоставлять обратный вызов состояния.
`statusChangeInterval`	Минимальное время в секундах между обратными вызовами в одноступенчатой из работы.
`clientContext`	Определяемые пользователем данные для соединения с этой работой. Для получения дополнительной информации посмотрите `FSFileOperationClientContext`. Этот параметр является дополнительным; передача `NULL` если Вы не должны предоставлять клиентский контекст.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

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

Objective C

@import CoreServices;

Доступность

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

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


    
    FSMoveObjectToTrashAsync
    FSMoveObjectToTrashAsync

(OS X v10.8)

Запускает асинхронную работу файла для перемещения исходного объекта в Мусор.

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

На уровне Foundation использовать trashItemAtURL:resultingItemURL:error: вместо этого.

Объявление

Objective C

OSStatus FSMoveObjectToTrashAsync ( FSFileOperationRef fileOp, const FSRef *source, OptionBits flags, FSFileOperationStatusProcPtr callback, CFTimeInterval statusChangeInterval, FSFileOperationClientContext *clientContext );

Параметры

`fileOp`	Объект операции файла Вы создали для этой операции пересылки. Для получения дополнительной информации посмотрите функцию `FSFileOperationCreate`.
`source`	Указатель на исходный объект для перемещения. Объект может быть файлом или каталогом.
`flags`	Один или более флагов опции работы файла. Посмотрите Опции Работы Файла.
`callback`	Функция обратного вызова для получения обновлений статуса как работы файла продолжается. Для получения дополнительной информации посмотрите Обратные вызовы Работы Файла. Этот параметр является дополнительным; передача `NULL` если Вы не должны предоставлять обратный вызов состояния.
`statusChangeInterval`	Минимальное время в секундах между обратными вызовами в одноступенчатой из работы.
`clientContext`	Определяемые пользователем данные для соединения с этой работой. Эти данные передаются функции, которую Вы указываете в `callback` параметр. Для получения дополнительной информации посмотрите `FSFileOperationClientContext`. Этот параметр является дополнительным; передача `NULL` если Вы не должны предоставлять клиентский контекст.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Эта функция запускает асинхронную работу файла для перемещения объекта, указанного source параметр к Мусору. Если исходный объем не будет поддерживать папку «Удаленные», то работа приведет к сбою и возвратит ошибку обратному вызову состояния, указанному в callback параметр. (Это - то же обстоятельство, сразу инициировавшее удаление поведения в Средстве поиска.)

Обратные вызовы состояния происходят на одном из runloop и комбинаций режима, на которые была запланирована работа. После успешного завершения работы, последнего currentItem параметр (передал последнему обратному вызову состояния или получил путем вызова FSFileOperationCopyStatus) объект в Мусоре.

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

Objective C

@import CoreServices;

Доступность

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

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


    
    FSPathCopyObjectAsync
    FSPathCopyObjectAsync

(OS X v10.8)

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

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

На уровне Foundation использовать copyItemAtPath:toPath:error: вместо этого. На уровне POSIX/BSD использовать copyfile(3) OS X Developer Tools Manual Page вместо этого.

Объявление

Objective C

OSStatus FSPathCopyObjectAsync ( FSFileOperationRef fileOp, const char *sourcePath, const char *destDirPath, CFStringRef destName, OptionBits flags, FSPathFileOperationStatusProcPtr callback, CFTimeInterval statusChangeInterval, FSFileOperationClientContext *clientContext );

Параметры

`fileOp`	Объект операции файла Вы создали для этой работы копии.
`sourcePath`	Путь UTF-8 исходного объекта для копирования. Объект может быть файлом или каталогом.
`destDirPath`	Путь UTF-8 целевого каталога.
`destName`	Имя для нового объекта в целевом каталоге. Передача `NULL` использовать имя исходного объекта.
`flags`	Один или более флагов опции работы файла. Посмотрите Опции Работы Файла.
`callback`	Функция обратного вызова для получения обновлений статуса как работы файла продолжается. Для получения дополнительной информации посмотрите Обратные вызовы Работы Файла. Этот параметр является дополнительным; передача `NULL` если Вы не должны предоставлять обратный вызов состояния.
`statusChangeInterval`	Минимальное время в секундах между обратными вызовами в одноступенчатой из работы.
`clientContext`	Определяемые пользователем данные для соединения с этой работой. Для получения дополнительной информации посмотрите `FSFileOperationClientContext`. Этот параметр является дополнительным; передача `NULL` если Вы не должны предоставлять клиентский контекст.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

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

Objective C

@import CoreServices;

Доступность

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

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


    
    FSPathMoveObjectAsync
    FSPathMoveObjectAsync

(OS X v10.8)

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

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

На уровне Foundation использовать moveItemAtPath:toPath:error: вместо этого. На уровне POSIX/BSD использовать rename(2) OS X Developer Tools Manual Page вместо этого.

Объявление

Objective C

OSStatus FSPathMoveObjectAsync ( FSFileOperationRef fileOp, const char *sourcePath, const char *destDirPath, CFStringRef destName, OptionBits flags, FSPathFileOperationStatusProcPtr callback, CFTimeInterval statusChangeInterval, FSFileOperationClientContext *clientContext );

Параметры

`fileOp`	Объект операции файла Вы создали для этой операции пересылки.
`sourcePath`	Путь UTF-8 исходного объекта для перемещения. Объект может быть файлом или каталогом.
`destDirPath`	Путь UTF-8 целевого каталога. Если целевой каталог не находится на том же объеме как исходный объект, исходный объект скопирован и затем удален.
`destName`	Имя для нового объекта в целевом каталоге. Передача `NULL` использовать имя исходного объекта.
`flags`	Один или более флагов опции работы файла. Посмотрите Опции Работы Файла. Если Вы указываете `kFSFileOperationDoNotMoveAcrossVolumes` флаг и целевой каталог не находятся на том же объеме как исходный объект, эта функция ничего не делает и возвращает ошибку.
`callback`	Функция обратного вызова для получения обновлений статуса как работы файла продолжается. Для получения дополнительной информации посмотрите Обратные вызовы Работы Файла. Этот параметр является дополнительным; передача `NULL` если Вы не должны предоставлять обратный вызов состояния.
`statusChangeInterval`	Минимальное время в секундах между обратными вызовами в одноступенчатой из работы.
`clientContext`	Определяемые пользователем данные для соединения с этой работой. Для получения дополнительной информации посмотрите `FSFileOperationClientContext`. Этот параметр является дополнительным; передача `NULL` если Вы не должны предоставлять клиентский контекст.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

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

Objective C

@import CoreServices;

Доступность

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

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


    
    FSPathMoveObjectToTrashAsync
    FSPathMoveObjectToTrashAsync

(OS X v10.8)

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

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

На уровне Foundation использовать trashItemAtURL:resultingItemURL:error: вместо этого.

Объявление

Objective C

OSStatus FSPathMoveObjectToTrashAsync ( FSFileOperationRef fileOp, const char *sourcePath, OptionBits flags, FSPathFileOperationStatusProcPtr callback, CFTimeInterval statusChangeInterval, FSFileOperationClientContext *clientContext );

Параметры

`fileOp`	Объект операции файла Вы создали для этой операции пересылки. Для получения дополнительной информации посмотрите функцию `FSFileOperationCreate`.
`sourcePath`	Путь UTF-8 исходного объекта для перемещения. Объект может быть файлом или каталогом.
`flags`	Один или более флагов опции работы файла. Посмотрите Опции Работы Файла.
`callback`	Функция обратного вызова для получения обновлений статуса как работы файла продолжается. Для получения дополнительной информации посмотрите Обратные вызовы Работы Файла. Этот параметр является дополнительным; передача `NULL` если Вы не должны предоставлять обратный вызов состояния.
`statusChangeInterval`	Минимальное время в секундах между обратными вызовами в одноступенчатой из работы.
`clientContext`	Определяемые пользователем данные для соединения с этой работой. Эти данные передаются функции, которую Вы указываете в `callback` параметр. Для получения дополнительной информации посмотрите `FSFileOperationClientContext`. Этот параметр является дополнительным; передача `NULL` если Вы не должны предоставлять клиентский контекст.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Эта функция запускает асинхронную работу файла для перемещения объекта, указанного sourcePath параметр к Мусору. Если исходный объем не будет поддерживать папку «Удаленные», то работа приведет к сбою и возвратит ошибку обратному вызову состояния, указанному в callback параметр. (Это - то же обстоятельство, сразу инициировавшее удаление поведения в Средстве поиска.)

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

Objective C

@import CoreServices;

Доступность

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

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


    
    FSFileOperationCopyStatus
    FSFileOperationCopyStatus

(OS X v10.8)

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

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

Объявление

Objective C

OSStatus FSFileOperationCopyStatus ( FSFileOperationRef fileOp, FSRef *currentItem, FSFileOperationStage *stage, OSStatus *error, CFDictionaryRef *statusDictionary, void **info );

Параметры

`fileOp`	Работа файла к доступу.
`currentItem`	Указатель на `FSRef` переменная. На выводе переменная содержит объект, в настоящее время перемещаемый или скопированный. Если работа завершена, этот параметр относится к цели (новый объект, соответствующий исходному объекту в целевом каталоге).
`stage`	Указатель на работу файла подготавливает переменную. На выводе переменная содержит текущий этап работы файла.
`error`	Указатель на ошибочную переменную состояния. На выводе переменная содержит текущее ошибочное состояние работы файла.
`statusDictionary`	Указатель на переменную словаря. На выводе переменная содержит словарь с более подробной информацией о статусе. Для получения информации о содержании словаря посмотрите `“File Operation Status Dictionary Keys”`. Необходимо выпустить словарь, когда Вы закончены с помощью него.
`info`	Указатель на универсальный указатель. На выводе универсальный указатель относится к определяемым пользователем данным, связанным с этой работой файла.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

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

Objective C

@import CoreServices;

Доступность

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

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


    
    FSPathFileOperationCopyStatus
    FSPathFileOperationCopyStatus

(OS X v10.8)

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

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

Объявление

Objective C

OSStatus FSPathFileOperationCopyStatus ( FSFileOperationRef fileOp, char **currentItem, FSFileOperationStage *stage, OSStatus *error, CFDictionaryRef *statusDictionary, void **info );

Параметры

`fileOp`	Работа файла к доступу.
`currentItem`	Указатель на символ* переменная. На выводе переменная относится к пути UTF-8 объекта, в настоящее время перемещаемого или скопированный. Если работа завершена, этот параметр относится к цели (новый объект, соответствующий исходному объекту в целевом каталоге). Необходимо освободить путь, когда Вы закончены с помощью него.
`stage`	Указатель на работу файла подготавливает переменную. На выводе переменная содержит текущий этап работы файла.
`error`	Указатель на ошибочную переменную состояния. На выводе переменная содержит текущее ошибочное состояние работы файла.
`statusDictionary`	Указатель на переменную словаря. На выводе переменная содержит словарь с более подробной информацией о статусе. Для получения информации о содержании словаря посмотрите `“File Operation Status Dictionary Keys”`. Необходимо выпустить словарь, когда Вы закончены с помощью него.
`info`	Указатель на универсальный указатель. На выводе универсальный указатель относится к определяемым пользователем данным, связанным с этой работой файла.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

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

Objective C

@import CoreServices;

Доступность

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

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

Копирование и перемещение объектов Используя синхронные высокоуровневые операции файла


    
    FSCopyObjectSync
    FSCopyObjectSync

(OS X v10.8)

Копирует исходный объект в целевой каталог.

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

Объявление

Objective C

OSStatus FSCopyObjectSync ( const FSRef *source, const FSRef *destDir, CFStringRef destName, FSRef *target, OptionBits options );

Параметры

`source`	Указатель на исходный объект для копирования. Объект может быть файлом или каталогом.
`destDir`	Указатель на целевой каталог.
`destName`	Имя для нового объекта в целевом каталоге. Передача `NULL` использовать имя исходного объекта.
`target`	Указатель на `FSRef` переменная, что, на выводе, относится к новому объекту в целевом каталоге. Этот параметр является дополнительным; передача `NULL` если Вы не должны обращаться к новому объекту.
`options`	Один или более флагов опции работы файла. Посмотрите Опции Работы Файла.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

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

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

Objective C

@import CoreServices;

Доступность

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

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


    
    FSMoveObjectSync
    FSMoveObjectSync

(OS X v10.8)

Перемещает исходный объект в целевой каталог.

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

Объявление

Objective C

OSStatus FSMoveObjectSync ( const FSRef *source, const FSRef *destDir, CFStringRef destName, FSRef *target, OptionBits options );

Параметры

`source`	Указатель на исходный объект для перемещения. Объект может быть файлом или каталогом. На выводе исходный объект больше не действителен; если Вы хотите обратиться к перемещенному объекту, необходимо использовать `FSRef` переменная, пасуемая назад в `target` параметр.
`destDir`	Указатель на целевой каталог. Если целевой каталог не находится на том же объеме как исходный объект, исходный объект скопирован и затем удален.
`destName`	Имя для нового объекта в целевом каталоге. Передача `NULL` использовать имя исходного объекта.
`target`	Указатель на `FSRef` переменная, что, на выводе, относится к новому объекту в целевом каталоге. Этот параметр является дополнительным; передача `NULL` если Вы не должны обращаться к новому объекту.
`options`	Один или более флагов опции работы файла. Посмотрите Опции Работы Файла. Если Вы указываете `kFSFileOperationDoNotMoveAcrossVolumes` флаг и целевой каталог не находятся на том же объеме как исходный объект, эта функция ничего не делает и возвращает ошибку.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

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

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

Objective C

@import CoreServices;

Доступность

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

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


    
    FSMoveObjectToTrashSync
    FSMoveObjectToTrashSync

(OS X v10.8)

Перемещает исходный объект в Мусор.

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

На уровне Foundation использовать trashItemAtURL:resultingItemURL:error: вместо этого.

Объявление

Objective C

OSStatus FSMoveObjectToTrashSync ( const FSRef *source, FSRef *target, OptionBits options );

Параметры

`source`	Указатель на исходный объект для перемещения. Объект может быть файлом или каталогом. На выводе исходный объект больше не действителен; если Вы хотите обратиться к перемещенному объекту, необходимо использовать значение, пасуемое назад в `target` параметр.
`target`	Указатель на целевой объект, что, на выводе, находится в папке «Удаленные». Этот параметр является дополнительным; передача `NULL` если Вы не должны обращаться к этому объекту.
`options`	Один или более флагов опции работы файла. Посмотрите Опции Работы Файла.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Эта функция перемещает файл или каталог в Мусор, корректируя имя объекта при необходимости. Надлежащая папка «Удаленные» выбрана на основе исходного объема и текущего пользователя. Если исходный объем не поддерживает папку «Удаленные», эта функция ничего не делает и возвращает ошибку. (Это - то же обстоятельство, сразу инициировавшее удаление поведения в Средстве поиска.)

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

Objective C

@import CoreServices;

Доступность

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

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


    
    FSPathCopyObjectSync
    FSPathCopyObjectSync

(OS X v10.8)

Копирует исходный объект в целевой каталог с помощью путей.

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

Объявление

Objective C

OSStatus FSPathCopyObjectSync ( const char *sourcePath, const char *destDirPath, CFStringRef destName, char **targetPath, OptionBits options );

Параметры

`sourcePath`	Путь UTF-8 исходного объекта для копирования. Объект может быть файлом или каталогом.
`destDirPath`	Путь UTF-8 целевого каталога.
`destName`	Имя для нового объекта в целевом каталоге. Передача `NULL` использовать имя исходного объекта.
`targetPath`	Указатель на символ* переменная, что, на выводе, относится к пути UTF-8 нового объекта в целевом каталоге. Если работа перестала работать, путь установлен в `NULL`. Когда Вам больше не нужен путь, необходимо освободить его. Этот параметр является дополнительным; передача `NULL` если Вам не нужен путь.
`options`	Один или более флагов опции работы файла. Посмотрите Опции Работы Файла.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

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

Objective C

@import CoreServices;

Доступность

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

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


    
    FSPathMoveObjectSync
    FSPathMoveObjectSync

(OS X v10.8)

Перемещает исходный объект в целевой каталог с помощью путей.

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

Объявление

Objective C

OSStatus FSPathMoveObjectSync ( const char *sourcePath, const char *destDirPath, CFStringRef destName, char **targetPath, OptionBits options );

Параметры

`sourcePath`	Путь UTF-8 исходного объекта для перемещения. Объект может быть файлом или каталогом.
`destDirPath`	Путь UTF-8 целевого каталога. Если целевой каталог не находится на том же объеме как исходный объект, исходный объект скопирован и затем удален.
`destName`	Имя для нового объекта в целевом каталоге. Передача `NULL` использовать имя исходного объекта.
`targetPath`	Указатель на символ* переменная, что, на выводе, относится к пути UTF-8 нового объекта в целевом каталоге. Когда Вам больше не нужен путь, необходимо освободить его. Если работа перестала работать, путь установлен в `NULL`. Этот параметр является дополнительным; передача `NULL` если Вам не нужен путь.
`options`	Один или более флагов опции работы файла. Посмотрите Опции Работы Файла. Если Вы указываете `kFSFileOperationDoNotMoveAcrossVolumes` флаг и целевой каталог не находятся на том же объеме как исходный объект, эта функция ничего не делает и возвращает ошибку.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

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

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

Objective C

@import CoreServices;

Доступность

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

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


    
    FSPathMoveObjectToTrashSync
    FSPathMoveObjectToTrashSync

(OS X v10.8)

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

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

На уровне Foundation использовать trashItemAtURL:resultingItemURL:error: вместо этого.

Объявление

Objective C

OSStatus FSPathMoveObjectToTrashSync ( const char *sourcePath, char **targetPath, OptionBits options );

Параметры

`sourcePath`	Путь UTF-8 исходного объекта для перемещения. Объект может быть файлом или каталогом.
`targetPath`	Указатель на символ* переменная, что, на выводе, относится к пути UTF-8 целевого объекта в Мусоре. Когда Вам больше не нужен путь, необходимо освободить его. Если работа перестала работать, путь установлен в `NULL`. Этот параметр является дополнительным; передача `NULL` если Вам не нужен путь.
`options`	Один или более флагов опции работы файла. Посмотрите Опции Работы Файла.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

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

Objective C

@import CoreServices;

Доступность

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

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

Создание ссылки файловой системы (FSRef)


    
    FSMakeFSRefUnicode
    FSMakeFSRefUnicode

(OS X v10.8)

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

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

Использовать NSURL или CFURL APIs вместо этого. Для отслеживания поведения элементов файловой системы ID создайте ссылку на файл использование URLs fileReferenceURL или CFURLCreateFileReferenceURL.

Объявление

Objective C

OSErr FSMakeFSRefUnicode ( const FSRef *parentRef, UniCharCount nameLength, const UniChar *name, TextEncoding textEncodingHint, FSRef *newRef );

Параметры

`parentRef`	Указатель на `FSRef` из родительского каталога файла или каталога, для которого можно создать новое `FSRef`. Посмотрите `FSRef` для описания `FSRef` тип данных.
`nameLength`	Длина имени файла или каталога.
`name`	Указатель на Unicode называет для файла или каталога. Имя должно быть листовым именем; частичные или полные пути не позволяются. Если у Вас есть частичный или полный путь в Unicode, необходимо будет проанализировать его сами и выполнить множественные вызовы к `FSMakeFSRefUnicode`.
`textEncodingHint`	Предложенное текстовое кодирование для использования при преобразовании имени Unicode файла или каталога к некоторому другому кодированию. Если Вы передаете константу `kTextEncodingUnknown`, Файловый менеджер будет использовать значение по умолчанию.
`newRef`	По возврату, если функция возвращает результат `noErr,` указатель на новое `FSRef`.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

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

Objective C

@import CoreServices;

Доступность

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

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


    
    PBMakeFSRefUnicodeSync
    PBMakeFSRefUnicodeSync

(OS X v10.8)

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

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

Объявление

Objective C

OSErr PBMakeFSRefUnicodeSync ( FSRefParam *paramBlock );

Параметры


      paramBlock

Указатель на блок параметра ссылки файловой системы. Посмотрите FSRefParam для описания FSRefParam тип данных.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ref`	На вводе, указателе на `FSRef` из родительского каталога файла или каталога, для которого можно создать новое `FSRef`. Посмотрите `FSRef` для описания `FSRef` тип данных.
`nameLength`	На вводе, длине имени файла или каталога.
`name`	На вводе указатель на Unicode называет для файла или каталога. Имя должно быть листовым именем; частичные или полные пути не позволяются. Если у Вас есть частичный или полный путь в Unicode, необходимо будет проанализировать его сами и выполнить множественные вызовы к `PBMakeFSRefUnicodeSync`.
`textEncodingHint`	На вводе, предложенном текстовом кодировании для использования при преобразовании имени Unicode файла или каталога к некоторому другому кодированию. Если Вы передаете константу `kTextEncodingUnknown`, Файловый менеджер будет использовать значение по умолчанию.
`newRef`	На выводе, если функция возвращает результат `noErr`, указатель на новое `FSRef`

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

Objective C

@import CoreServices;

Доступность

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

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


    
    PBMakeFSRefUnicodeAsync
    PBMakeFSRefUnicodeAsync

(OS X v10.8)

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

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

Объявление

Objective C

void PBMakeFSRefUnicodeAsync ( FSRefParam *paramBlock );

Параметры


      paramBlock

Указатель на блок параметра ссылки файловой системы. Посмотрите FSRefParam для описания FSRefParam тип данных.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на функцию завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции.
`ref`	На вводе, указателе на `FSRef` из родительского каталога файла или каталога, для которого можно создать новое `FSRef`. Посмотрите `FSRef` для описания `FSRef` тип данных.
`nameLength`	На вводе, длине имени файла или каталога.
`name`	На вводе указатель на Unicode называет для файла или каталога. Имя должно быть листовым именем; частичные или полные пути не позволяются. Если у Вас есть частичный или полный путь в Unicode, необходимо будет проанализировать его сами и выполнить множественные вызовы к `PBMakeFSRefUnicodeAsync`.
`textEncodingHint`	На вводе, предложенном текстовом кодировании для использования при преобразовании имени Unicode файла или каталога к некоторому другому кодированию. Если Вы передаете константу `kTextEncodingUnknown`, Файловый менеджер будет использовать значение по умолчанию.
`newRef`	На выводе, если функция возвращает результат `noErr`, указатель на новое `FSRef`

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

Objective C

@import CoreServices;

Доступность

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

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


    
    FSpMakeFSRef
    FSpMakeFSRef

(OS X v10.5)

Создает FSRef для файла или каталога, данного FSSpec.

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

Нет никакой заменяющей функции.

Объявление

Objective C

OSErr FSpMakeFSRef ( const FSSpec *source, FSRef *newRef );

Параметры


      source

Указатель на FSSpec для файла или каталога. Этот параметр должен указать на допустимое FSSpec для существующего файла или каталога; если это не сделает, то вызов возвратится fnfErr. Посмотрите FSSpec для описания FSSpec тип данных.


      newRef

На вводе, указателе на FSRef структура. По возврату, указателю на FSRef для файла или каталога, указанного в FSSpec указанный в source параметр.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Получить FSSpec от FSRef, используйте FSGetCatalogInfo функция.

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

Objective C

@import CoreServices;

Доступность

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

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

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


    
    PBMakeFSRefSync
    PBMakeFSRefSync

(OS X v10.5)

Создает FSRef для файла или каталога, данного FSSpec.

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

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

Объявление

Objective C

OSErr PBMakeFSRefSync ( FSRefParam *paramBlock );

Параметры


      paramBlock

Указатель на блок параметра ссылки файловой системы. Посмотрите FSRefParam для описания FSRefParam тип данных.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Для параметра блок базировал вызовы, поля источника FSSpec передаются как отдельные параметры (в ioNamePtr, ioVRefNum, и ioDirID поля). Это позволяет вызову быть диспетчеризированным внешним файловым системам тот же путь как другой FSp вызовы.

Соответствующие поля блока параметра:

`ioNamePtr`	На вводе, указателе на имя файла или каталога, для которого Вы хотите создать `FSRef`.
`ioVRefNum`	На вводе, спецификации объема для объема, содержащего файл или каталог. Это может быть ссылочным номером объема, числом диска, или 0 для объема по умолчанию.
`ioDirID`	На вводе, каталоге ID родительского каталога файла или каталога.
`newRef`	На вводе, указателе на `FSRef` структура. На выводе, этом `FSRef` относится к указанному файлу или каталогу.

Получить FSSpec от FSRef, используйте PBGetCatalogInfoSync функция.

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

Objective C

@import CoreServices;

Доступность

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

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

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


    
    PBMakeFSRefAsync
    PBMakeFSRefAsync

(OS X v10.5)

Создает FSRef для файла или каталога, данного FSSpec.

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

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

Объявление

Objective C

void PBMakeFSRefAsync ( FSRefParam *paramBlock );

Параметры


      paramBlock

Указатель на блок параметра ссылки файловой системы. Посмотрите FSRefParam для описания FSRefParam тип данных.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции.
`ioNamePtr`	На вводе, указателе на имя файла или каталога, для которого Вы хотите создать `FSRef`.
`ioVRefNum`	На вводе, спецификации объема для объема, содержащего файл или каталог. Это может быть ссылочным номером объема, числом диска, или 0 для объема по умолчанию.
`ioDirID`	На вводе, каталоге ID родительского каталога файла или каталога.
`newRef`	На вводе, указателе на `FSRef` структура. На выводе, этом `FSRef` относится к указанному файлу или каталогу.

Получить FSSpec от FSRef, используйте PBGetCatalogInfoAsync вызвать.

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

Objective C

@import CoreServices;

Доступность

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

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

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

FSIsFSRefValid FSIsFSRefValid (OS X v10.8)

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

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

На уровне Foundation использовать checkResourceIsReachableAndReturnError: вместо этого; на уровне Core Foundation использовать CFURLResourceIsReachable вместо этого.

Объявление

Objective C

Boolean FSIsFSRefValid ( const FSRef *ref );

Параметры

ref

Ссылка файловой системы.

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

Возвраты TRUE если данная ссылка файловой системы относится к системному объекту правильного файла; иначе, FALSE.

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

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.4 и позже.
Осуждаемый в OS X v10.8.

Создание и удаление ссылок идентификатора файла


    
    PBCreateFileIDRefSync
    PBCreateFileIDRefSync

(OS X v10.5)

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

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

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

Объявление

Objective C

OSErr PBCreateFileIDRefSync ( HParmBlkPtr paramBlock );

Параметры


      paramBlock

Указатель на FIDParam вариант блока параметра HFS. Посмотрите HParamBlockRec для описания HParamBlockRec тип данных.

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

Код результата. Посмотрите Коды Результата Файлового менеджера.PBCreateFileIDRefSync возвращает код результата fidExists если ссылка идентификатора файла уже существует для файла.

Обсуждение

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

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

`ioNamePtr`	На вводе, указателе на имя файла.
`ioVRefNum`	На вводе, ссылочном номере объема для объема, содержащего файл.
`ioSrcDirID`	На вводе, родительский каталог файла ID.
`ioFileID`	На выводе, идентификаторе файла. Если ссылка идентификатора файла уже существует для файла, `PBCreateFileIDRefSync` предоставляет идентификатор файла, но возвращает код результата `fidExists`.

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

Objective C

@import CoreServices;

Доступность

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

Осуждаемый в OS X v10.5.

Не доступный 64-разрядным приложениям.


    
    PBCreateFileIDRefAsync
    PBCreateFileIDRefAsync

(OS X v10.5)

Устанавливает ссылку идентификатора файла для файла.

Оператор осуждения

Использовать FSGetCatalogInfo вместо этого.

Объявление

Objective C

OSErr PBCreateFileIDRefAsync ( HParmBlkPtr paramBlock );

Параметры


      paramBlock

Указатель на FIDParam вариант блока параметра HFS. Посмотрите HParamBlockRec для описания HParamBlockRec тип данных.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Учитывая ссылочный номер объема, имя файла и родительский каталог ID, PBCreateFileIDRefAsync функция создает структуру для содержания имени и родительского каталога ID указанного файла. Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции. `PBCreateFileIDRefAsync` возвращает код результата `fidExists` если ссылка идентификатора файла уже существует для файла.
`ioNamePtr`	На вводе, указателе на имя файла.
`ioVRefNum`	На вводе, ссылочном номере объема для объема, содержащего файл.
`ioSrcDirID`	На вводе, родительский каталог файла ID.
`ioFileID`	На выводе, идентификаторе файла. Если ссылка идентификатора файла уже существует для файла, `PBCreateFileIDRefAsync` предоставляет идентификатор файла, но возвращает код результата `fidExists`.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.5.

Не доступный 64-разрядным приложениям.


    
    PBDeleteFileIDRefSync
    PBDeleteFileIDRefSync

(OS X v10.5)

Удаляет ссылку идентификатора файла.

Оператор осуждения

Нет никакой заменяющей функции.

Объявление

Objective C

OSErr PBDeleteFileIDRefSync ( HParmBlkPtr paramBlock );

Параметры


      paramBlock

Указатель на FIDParam вариант блока параметра HFS. Посмотрите HParamBlockRec для описания HParamBlockRec тип данных.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioNamePtr`	На вводе, указателе на путь.
`ioVRefNum`	На вводе, спецификации объема для объема, содержащего файл.
`ioFileID`	На вводе, ссылка идентификатора файла для удаления. После того, как это лишило законной силы ссылку идентификатора файла, Файловый менеджер больше не может разрешать что ссылка ID на имя файла и родительский каталог ID.

Специальные замечания

Эта функция не реализована в OS X.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.5.

Не доступный 64-разрядным приложениям.


    
    PBDeleteFileIDRefAsync
    PBDeleteFileIDRefAsync

(OS X v10.5)

Удаляет ссылку идентификатора файла.

Оператор осуждения

Нет никакой заменяющей функции.

Объявление

Objective C

OSErr PBDeleteFileIDRefAsync ( HParmBlkPtr paramBlock );

Параметры


      paramBlock

Указатель на FIDParam вариант блока параметра HFS. Посмотрите HParamBlockRec для описания HParamBlockRec тип данных.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции.
`ioNamePtr`	На вводе, указателе на путь.
`ioVRefNum`	На вводе, спецификации объема для объема, содержащего файл.
`ioFileID`	На вводе, ссылка идентификатора файла для удаления. После того, как это лишило законной силы ссылку идентификатора файла, Файловый менеджер больше не может разрешать что ссылка ID на имя файла и родительский каталог ID.

Специальные замечания

Эта функция не реализована в OS X.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.5.

Не доступный 64-разрядным приложениям.

Создание и удаление названного ветвлениями


    
    FSCreateFork
    FSCreateFork

(OS X v10.8)

Создает именованное ветвление для файла или каталога.

Оператор осуждения

Когда Вы используете, на уровне POSIX/BSD создается ветвь данных truncate или write(2) OS X Developer Tools Manual Page установить EOF к значению, больше, чем 0.

Объявление

Objective C

OSErr FSCreateFork ( const FSRef *ref, UniCharCount forkNameLength, const UniChar *forkName );

Параметры

`ref`	Указатель на `FSRef` указание файла или каталога. Посмотрите `FSRef` для описания `FSRef` тип данных.
`forkNameLength`	Длина имени нового ветвления.
`forkName`	Указатель на имя Unicode ветвления.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера. Если именованное ветвление уже существует, функциональные возвраты errFSForkExists. Если имя ветвления синтаксически недопустимо или иначе неподдерживаемое для данного объема, FSCreateFork возвраты errFSBadForkName или errFSNameTooLong.

Обсуждение

Недавно создаваемое ветвление имеет нулевую длину (т.е. ее логический конец файла является нулем). Ветви данных и ветви ресурсов файла автоматически созданы и удалены по мере необходимости. Это сделано для совместимости с более старым APIs, и потому что ветви данных и ветви ресурсов часто обрабатываются особенно. Если данное ветвление всегда существует для данного формата объема (такого как ветви данных и ветви ресурсов для HFS и HFS Плюс, или ветви данных для большинства других форматов объема), попытка создать то ветвление, когда ветвление нулевой длины уже существует, должен возвратиться noErr; если непустое ветвление уже существует тогда errFSForkExists должен быть возвращен.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    PBCreateForkSync
    PBCreateForkSync

(OS X v10.8)

Создает именованное ветвление для файла или каталога.

Оператор осуждения

Объявление

Objective C

OSErr PBCreateForkSync ( FSForkIOParam *paramBlock );

Параметры


      paramBlock

Указатель на ветвление блок параметра I/O. Посмотрите FSForkIOParam для описания FSForkIOParam тип данных.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.. Если именованное ветвление уже существует, функциональные возвраты errFSForkExists. Если имя ветвления синтаксически недопустимо или иначе неподдерживаемое для данного объема, PBCreateForkSync возвраты errFSBadForkName или errFSNameTooLong.

Обсуждение

Соответствующие поля блока параметра:

`ioResult`	На выводе, коде результата функции. Если именованное ветвление уже существует, функциональные возвраты `errFSForkExists`. Если имя ветвления синтаксически недопустимо или иначе неподдерживаемое для данного объема, `PBCreateForkAsync` возвраты `errFSBadForkName` или `errFSNameTooLong`.
`ref`	На вводе, указателе на `FSRef` указание файла или каталога.
`forkNameLength`	На вводе, длине имени Unicode нового ветвления.
`forkName`	На вводе, указателе на имя Unicode ветвления.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    PBCreateForkAsync
    PBCreateForkAsync

(OS X v10.8)

Создает именованное ветвление для файла или каталога.

Оператор осуждения

Объявление

Objective C

void PBCreateForkAsync ( FSForkIOParam *paramBlock );

Параметры


      paramBlock

Указатель на ветвление блок параметра I/O. Посмотрите FSForkIOParam для описания FSForkIOParam тип данных.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции. Если именованное ветвление уже существует, функциональные возвраты `errFSForkExists`. Если имя ветвления синтаксически недопустимо или иначе неподдерживаемое для данного объема, `PBCreateForkAsync` возвраты `errFSBadForkName` или `errFSNameTooLong`.
`ref`	На вводе, указателе на `FSRef` указание файла или каталога.
`forkNameLength`	На вводе, длине имени Unicode нового ветвления.
`forkName`	На вводе, указателе на имя Unicode ветвления.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    FSDeleteFork
    FSDeleteFork

(OS X v10.8)

Удаляет именованное ветвление из файла или каталога.

Оператор осуждения

Когда Вы устанавливаете, на уровне POSIX/BSD удалена ветвь данных EOF значение к 0 использование truncate с длиной 0. Ветвь ресурсов удалена путем удаления XATTR_RESOURCEFORK_NAME расширенный атрибут с removexattr.

Объявление

Objective C

OSErr FSDeleteFork ( const FSRef *ref, UniCharCount forkNameLength, const UniChar *forkName );

Параметры

`ref`	Указатель на `FSRef` для файла или каталога, из которого можно удалить ветвление. Посмотрите `FSRef` для описания `FSRef` тип данных.
`forkNameLength`	Длина имени Unicode имени ветвления.
`forkName`	Указатель на имя Unicode ветвления для удаления.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера. Если именованное ветвление не существует, функциональные возвраты errFSForkNotFound.

Обсуждение

Любое хранение, выделенное ветвлению, выпущено. Если данное ветвление всегда существует для данного формата объема (такого как ветви данных и ветви ресурсов для HFS и HFS Плюс, или ветви данных для большинства других форматов объема), это эквивалентно обнулению логического размера ветвления.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    PBDeleteForkSync
    PBDeleteForkSync

(OS X v10.8)

Удаляет именованное ветвление из файла или каталога.

Оператор осуждения

Объявление

Objective C

OSErr PBDeleteForkSync ( FSForkIOParam *paramBlock );

Параметры


      paramBlock

Указатель на ветвление блок параметра I/O. Посмотрите FSForkIOParam для описания FSForkIOParam тип данных.

Возвращаемое значение

Обсуждение

Соответствующие поля блока параметра:

`ref`	На вводе, указателе на `FSRef` для файла или каталога, из которого можно удалить ветвление.
`forkNameLength`	На вводе, длине имени Unicode ветвления.
`forkName`	На вводе, указателе на имя Unicode ветвления для удаления.

permissions, forkRefNum, positionMode, и positionOffset поля блока параметра могут быть изменены этим вызовом.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    PBDeleteForkAsync
    PBDeleteForkAsync

(OS X v10.8)

Удаляет именованное ветвление файла или каталога.

Оператор осуждения

Объявление

Objective C

void PBDeleteForkAsync ( FSForkIOParam *paramBlock );

Параметры


      paramBlock

Указатель на ветвление блок параметра I/O. Посмотрите FSForkIOParam для описания FSForkIOParam тип данных.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции. Если именованное ветвление не существует, функциональные возвраты `errFSForkNotFound`.
`ref`	На вводе, указателе на `FSRef` для файла или каталога, из которого можно удалить ветвление.
`forkNameLength`	На вводе, длине имени Unicode ветвления.
`forkName`	На вводе, указателе на имя Unicode ветвления для удаления.

permissions, forkRefNum, positionMode, и positionOffset поля блока параметра могут быть изменены этим вызовом.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.

Создание каталогов


    
    FSCreateDirectoryUnicode
    FSCreateDirectoryUnicode

(OS X v10.8)

Создает новый каталог (папка) с именем Unicode.

Оператор осуждения

На уровне Foundation использовать createDirectoryAtURL:withIntermediateDirectories:attributes:error: вместо этого. На уровне POSIX/BSD использовать mkdir(2) OS X Developer Tools Manual Page вместо этого.

Объявление

Objective C

OSErr FSCreateDirectoryUnicode ( const FSRef *parentRef, UniCharCount nameLength, const UniChar *name, FSCatalogInfoBitmap whichInfo, const FSCatalogInfo *catalogInfo, FSRef *newRef, FSSpecPtr newSpec, UInt32 *newDirID );

Параметры

`parentRef`	Указатель на `FSRef` указание родительского каталога, где должен быть создан новый каталог. Посмотрите `FSRef` для описания `FSRef` тип данных.
`nameLength`	Длина имени Unicode нового каталога.
`name`	Указатель на имя Unicode нового каталога.
`whichInfo`	Битовый массив, указывающий, который поля информации о каталоге установить для нового каталога. Укажите значения для этих полей в `catalogInfo` параметр. Если Вы не хотите устанавливать информацию о каталоге для нового каталога, укажите константу `kFSCatInfoNone`. Посмотрите Растровые Константы информации о Каталоге для описания битов, определенных для этого параметра.
`catalogInfo`	Указатель на `FSCatalogInfo` структура, указывающая значения для полей информации о каталоге для нового каталога. Укажите который поля начаться `whichInfo` параметр. Этот параметр является дополнительным; указать `NULL` если Вы не хотите устанавливать информацию о каталоге для нового каталога. Посмотрите `FSCatalogInfo` для описания `FSCatalogInfo` тип данных.
`newRef`	По возврату, указателю на `FSRef` для нового каталога. Этот параметр является дополнительным; указать `NULL` если Вы не хотите `FSRef` возвращенный.
`newSpec`	По возврату, указателю на `FSSpec` для нового каталога. Этот параметр является дополнительным; указать `NULL` если Вы не хотите `FSSpec` возвращенный. Посмотрите `FSSpec` для описания `FSSpec` тип данных.
`newDirID`	По возврату, указателю на каталог ID каталога. Этот параметр является дополнительным; указать `NULL` если Вы не хотите возвращенный каталог ID.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Можно дополнительно установить информацию о каталоге для нового каталога с помощью whichInfo и catalogInfo параметры; это эквивалентно вызову FSSetCatalogInfo , или один из соответствующего параметра блокирует функции, PBSetCatalogInfoSync и PBSetCatalogInfoAsync , после создания каталога.

Если возможно, необходимо установить textEncodingHint поле информационной структуры каталога, указанной в catalogInfo параметр. Это будет использоваться форматом объема при преобразовании имени файла Unicode в другие кодировки.

Специальные замечания

Если FSCreateDirectoryUnicode функция присутствует, но не реализована определенным объемом, Файловый менеджер будет эмулировать эту функцию путем совершения надлежащего звонка к PBDirCreateSync. Однако, если функция не будет непосредственно поддерживаться объемом, то Вы не будете в состоянии использовать долгие имена каталогов Unicode или другие опции, добавленные с HFS Плюс.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    FSpDirCreate
    FSpDirCreate

(OS X v10.4)

Создает новый каталог.

Оператор осуждения

Использовать FSCreateDirectoryUnicode вместо этого.

Объявление

Objective C

OSErr FSpDirCreate ( const FSSpec *spec, ScriptCode scriptTag, SInt32 *createdDirID );

Параметры

`spec`	Указатель на `FSSpec` структура, указывающая каталог, который будет создаваться. Обратите внимание на то, что, если родительский каталог ID для каталога описан этим `FSSpec` 0 и объем, указанный в этом `FSSpec` объем по умолчанию, новый каталог помещается в каталог по умолчанию объема. Если родительский каталог, который ID 0 и указанный объем, является объемом кроме объема по умолчанию, новый каталог помещается в корневой каталог объема. Для создания каталога в корне объема, независимо от того, является ли тот объем текущим объемом по умолчанию, устанавливает родительский каталог ID в константу `fsRtDirID`(2).
`scriptTag`	Код системы сценария, в которой должно быть выведено на экран имя каталога. Если Вы установили название и местоположение нового каталога с помощью любого `NavAskSaveChanges` или `NavCustomAskSaveChanges` функционируйте, укажите, что код сценария возвратился в структуре ответа. Иначе, укажите системный сценарий путем установки `scriptTag` параметр к значению `smSystemScript`. Для получения дополнительной информации о функциях `NavAskSaveChanges` и `NavCustomAskSaveChanges`, посмотрите Программирование С Navigation Services. Для описания `smSystemScript` постоянный, посмотрите менеджера по Сценарию Референса.
`createdDirID`	По возврату, указателю на каталог ID создававшегося каталога.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

FSpDirCreate функционируйте устанавливает дату и время создания и последнего изменения к текущей дате и время.

Прежде, чем вызвать эту функцию, необходимо вызвать Gestalt функционируйте, чтобы проверить, что функция доступна. Если FSpDirCreate не доступно, можно использовать функцию DirCreate вместо этого. Для создания каталога с именем Unicode используйте функцию FSCreateDirectoryUnicode , или один из соответствующего параметра блокирует вызовы, PBCreateDirectoryUnicodeSync и PBCreateDirectoryUnicodeAsync.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    PBCreateDirectoryUnicodeSync
    PBCreateDirectoryUnicodeSync

(OS X v10.8)

Создает новый каталог (папка) с именем Unicode.

Оператор осуждения

Объявление

Objective C

OSErr PBCreateDirectoryUnicodeSync ( FSRefParam *paramBlock );

Параметры


      paramBlock

Указатель на блок параметра ссылки файловой системы. Посмотрите FSRefParam для описания FSRefParam тип данных.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ref`	На вводе, указателе на `FSRef` для родительского каталога, где должен быть создан новый каталог.
`nameLength`	На вводе, числе символов Unicode на имя нового каталога.
`name`	На вводе, указателе на имя Unicode нового каталога.
`whichInfo`	На вводе, битовый массив, указывающий, который поля информации о каталоге установить для нового каталога. Укажите значения для этих полей в `catInfo` поле. Если Вы не хотите устанавливать информацию о каталоге для нового каталога, укажите константу `kFSCatInfoNone`. Посмотрите Растровые Константы информации о Каталоге для описания битов, определенных для этого поля.
`catInfo`	На вводе, указателе на `FSCatalogInfo` структура, указывающая значения полей информации о каталоге нового каталога. Укажите который поля начаться `whichInfo` поле. Указать `NULL` если Вы не хотите устанавливать информацию о каталоге для нового каталога.
`newRef`	На выводе, указателе на `FSRef` для нового каталога. Если Вы не хотите `FSRef` возвращенный, передача `NULL` на вводе.
`spec`	На выводе, указателе на `FSSpec` для нового каталога. Если Вы не хотите `FSSpec` возвращенный, передача `NULL` на вводе.
`ioDirID`	На выводе, каталоге ID нового каталога.

Можно дополнительно установить информацию о каталоге для нового каталога с помощью whichInfo и catInfo поля; это эквивалентно вызову FSSetCatalogInfo , или один из соответствующего параметра блокирует функции, PBSetCatalogInfoSync и PBSetCatalogInfoAsync , после создания каталога.

Если возможно, необходимо установить textEncodingHint поле информационной структуры каталога, указанной в catInfo поле. Это будет использоваться форматом объема при преобразовании имени файла Unicode в другие кодировки.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    DirCreate
    DirCreate

(OS X v10.4)

Создает новый каталог.

Оператор осуждения

Использовать FSCreateDirectoryUnicode вместо этого.

Объявление

Objective C

OSErr DirCreate ( FSVolumeRefNum vRefNum, SInt32 parentDirID, ConstStr255Param directoryName, SInt32 *createdDirID );

Параметры

`vRefNum`	Ссылочный номер объема, управляйте числом, или 0 для объема по умолчанию.
`parentDirID`	Каталог ID родительского каталога. Если родительский каталог ID 0 и объем, указанный в `vRefNum` параметр является объемом по умолчанию, новый каталог помещается в каталог по умолчанию объема. Если родительский каталог ID 0 и объем, указанный в `vRefNum` параметр является объемом кроме объема по умолчанию, новый каталог помещается в корневой каталог объема. Для создания каталога в корне объема, независимо от того, является ли тот объем текущим объемом по умолчанию, передают константу `fsRtDirID`(2) в этом параметре.
`directoryName`	Имя нового каталога.
`createdDirID`	По возврату, указателю на каталог ID нового каталога. Обратите внимание на то, что каталог ID, в отличие от ссылочного номера объема, является длинным целым.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Дата и время создания нового каталога и последнего изменения установлена в текущую дату и время.

Для создания каталога с именем Unicode используйте функцию FSCreateDirectoryUnicode , или один из соответствующего параметра блокирует вызовы, PBCreateDirectoryUnicodeSync и PBCreateDirectoryUnicodeAsync.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    PBCreateDirectoryUnicodeAsync
    PBCreateDirectoryUnicodeAsync

(OS X v10.8)

Создает новый каталог (папка) с именем Unicode.

Оператор осуждения

Объявление

Objective C

void PBCreateDirectoryUnicodeAsync ( FSRefParam *paramBlock );

Параметры


      paramBlock

Указатель на блок параметра ссылки файловой системы. Посмотрите FSRefParam для описания FSRefParam тип данных.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения, посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции. См. “Коды Результата Файлового менеджера”.
`ref`	На вводе, указателе на `FSRef` для родительского каталога, где должен быть создан новый каталог.
`nameLength`	На вводе, числе символов Unicode на имя нового каталога.
`name`	На вводе, указателе на имя Unicode нового каталога.
`whichInfo`	На вводе, битовый массив, указывающий, который поля информации о каталоге установить для нового каталога. Укажите значения для этих полей в `catInfo` поле. Если Вы не хотите устанавливать информацию о каталоге для нового каталога, укажите константу `kFSCatInfoNone`. Посмотрите Растровые Константы информации о Каталоге для описания битов, определенных для этого поля.
`catInfo`	На вводе, указателе на `FSCatalogInfo` структура, указывающая значения полей информации о каталоге нового каталога. Укажите который поля начаться `whichInfo` поле. Указать `NULL` если Вы не хотите устанавливать информацию о каталоге для нового каталога.
`newRef`	На выводе, указателе на `FSRef` для нового каталога. Если Вы не хотите `FSRef` возвращенный, передача `NULL` на вводе.
`spec`	На выводе, указателе на `FSSpec` для нового каталога. Если Вы не хотите `FSSpec` возвращенный, передача `NULL` на вводе.
`ioDirID`	На выводе, каталоге ID нового каталога.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    PBDirCreateSync
    PBDirCreateSync

(OS X v10.4)

Создает новый каталог.

Оператор осуждения

Использовать PBCreateDirectoryUnicodeSync вместо этого.

Объявление

Objective C

OSErr PBDirCreateSync ( HParmBlkPtr paramBlock );

Параметры


      paramBlock

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioNamePtr`	На вводе, указателе на имя для нового каталога.
`ioVRefNum`	На вводе, ссылочном номере объема, числе диска, или 0 для объема по умолчанию.
`ioDirID`	На вводе, родительский каталог ID. Если родительский каталог ID 0 и объем, указанный в `ioVRefNum` поле является объемом по умолчанию, новый каталог помещается в каталог по умолчанию объема. Если родительский каталог ID 0 и объем, указанный в `ioVRefNum` поле является объемом кроме объема по умолчанию, новый каталог помещается в корневой каталог объема. Для создания каталога в корне объема, независимо от того, является ли тот объем текущим объемом по умолчанию, передают константу `fsRtDirID` (2) в этом поле. На выводе, каталоге ID нового каталога. Обратите внимание на то, что каталог ID, в отличие от ссылочного номера объема, является длинным целым.

PBDirCreateSync функция идентична PBHCreateSync за исключением того, что это создает новый каталог вместо файла. Дата и время создания каталога и последнего изменения установлена в текущую дату и время.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    PBDirCreateAsync
    PBDirCreateAsync

(OS X v10.4)

Создает новый каталог.

Оператор осуждения

Использовать PBCreateDirectoryUnicodeAsync вместо этого.

Объявление

Objective C

OSErr PBDirCreateAsync ( HParmBlkPtr paramBlock );

Параметры


      paramBlock

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на функцию завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции.
`ioNamePtr`	На вводе, указателе на имя для нового каталога.
`ioVRefNum`	На вводе, ссылочном номере объема, числе диска, или 0 для объема по умолчанию.
`ioDirID`	На вводе, родительский каталог ID. Если родительский каталог ID 0 и объем, указанный в `ioVRefNum` поле является объемом по умолчанию, новый каталог помещается в каталог по умолчанию объема. Если родительский каталог ID 0 и объем, указанный в `ioVRefNum` поле является объемом кроме объема по умолчанию, новый каталог помещается в корневой каталог объема. Для создания каталога в корне объема, независимо от того, является ли тот объем текущим объемом по умолчанию, передают константу `fsRtDirID` (2) в этом поле. На выводе, каталоге ID нового каталога. Обратите внимание на то, что каталог ID, в отличие от ссылочного номера объема, является длинным целым.

PBDirCreateAsync функция идентична PBHCreateAsync за исключением того, что это создает новый каталог вместо файла. Дата и время создания каталога и последнего изменения установлена в текущую дату и время.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.

Создание объектов FSFileSecurity

FSFileSecurityCreate FSFileSecurityCreate (OS X v10.8)

Создает FSFileSecurity объект.

Оператор осуждения

Использовать CFFileSecurityCreate вместо этого.

Объявление

Objective C

FSFileSecurityRef FSFileSecurityCreate ( CFAllocatorRef alloc );

Параметры

alloc

CFAllocator использовать.

Возвращаемое значение

Возвращает новое FSFileSecurity объект или NULL если создание перестало работать.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.4 и позже.
Осуждаемый в OS X v10.8.


    
    FSFileSecurityRefCreateCopy
    FSFileSecurityRefCreateCopy

(OS X v10.8)

Создает копию FSFileSecurity объект.

Оператор осуждения

Использовать CFFileSecurityCreateCopy вместо этого.

Объявление

Objective C

FSFileSecurityRef FSFileSecurityRefCreateCopy ( CFAllocatorRef alloc, FSFileSecurityRef fileSec );

Параметры

`alloc`	`CFAllocator` использовать.
`fileSec`	`FSFileSecurity` возразите для копирования.

Возвращаемое значение

Возвращает новое FSFileSecurity или NULL если создание перестало работать.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.4 и позже.

Осуждаемый в OS X v10.8.


    
    FSFileSecurityCreateWithFSPermissionInfo
    FSFileSecurityCreateWithFSPermissionInfo

(OS X v10.8)

Создает FSFileSecurity объект с данными данными полномочий.

Оператор осуждения

Использовать CFFileSecurity APIs вместо этого (см. Ссылку CFFileSecurity).

Объявление

Objective C

FSFileSecurityRef FSFileSecurityCreateWithFSPermissionInfo ( CFAllocatorRef alloc, const FSPermissionInfo *permissions );

Параметры

`alloc`	`CFAllocator` использовать.
`permissions`	Структура, содержащая пользователя и данные полномочий группы для режима доступа.

Возвращаемое значение

Ссылка на недавно созданный объект или NULL если создание перестало работать.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.4 и позже.

Осуждаемый в OS X v10.8.

Создание спецификаций файловой системы


    
    FSMakeFSSpec
    FSMakeFSSpec

(OS X v10.4)

Создает FSSpec структура, описывающая файл или каталог.

Оператор осуждения

Использовать FSMakeFSRefUnicode вместо этого.

Объявление

Objective C

OSErr FSMakeFSSpec ( FSVolumeRefNum vRefNum, SInt32 dirID, ConstStr255Param fileName, FSSpec *spec );

Параметры

`vRefNum`	Спецификация объема для объема, содержащего файл или каталог. Этот параметр может содержать ссылочный номер объема, число диска, или 0 для указания объема по умолчанию.
`dirID`	Родительский каталог ID целевого объекта. Если каталог достаточно указан в `fileName` параметр, `dirID` параметр может быть установлен на 0. Если `fileName` параметр содержит пустую строку, `FSMakeFSSpec` создает `FSSpec` структура для каталога, указанного `dirID` параметр.
`fileName`	Полный или частичный путь. Если `fileName` параметр указывает полный путь, `FSMakeFSSpec` игнорирует обоих `vRefNum` и `dirID` параметры. Частичный путь мог бы идентифицировать только заключительную цель, или это могло бы включать одно или более имен родительского каталога. Если `fileName` указывает частичный путь, тогда `vRefNum`, `dirID`, или оба должны быть допустимыми.
`spec`	Указатель на спецификацию файловой системы, чтобы быть заполненным в `FSMakeFSSpec`. `FSMakeFSSpec` функция заполняет поля спецификации файловой системы с помощью информации, содержавшейся в других трех параметрах. Если Ваше приложение получает какой-либо код результата кроме `noErr` или `fnfErr`, все поля получающегося `FSSpec` структура установлена в 0. Структура спецификации файловой системы, которую Вы передаете в этом параметре, не должна совместно использовать пространство памяти с входным путем; `name` поле может быть инициализировано к пустой строке, прежде чем был обработан путь. Например, `fileName` не должен относиться к `name` поле системной спецификации выходного файла.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Необходимо вызвать FSMakeFSSpec, или один из соответствующего параметра блокирует функции, PBMakeFSSpecSync и PBMakeFSSpecAsync , каждый раз, когда Вы хотите создать FSSpec структура. Вы не должны создавать FSSpec путем заполнения полей структуры самостоятельно.

Если указанный объем смонтирован, и указанный родительский каталог существует, но конечный файл или каталог не существуют в том расположении, FSMakeFSSpec заполняет структуру и затем возвращается fnfErr вместо noErr. Структура допустима, но она описывает не существующую цель. Можно использовать структуру для других операций, таких как создание файла с FSpCreate функция.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    PBMakeFSSpecSync
    PBMakeFSSpecSync

(OS X v10.4)

Создает FSSpec структура для файла или каталога.

Оператор осуждения

Использовать PBMakeFSRefUnicodeSync вместо этого.

Объявление

Objective C

OSErr PBMakeFSSpecSync ( HParmBlkPtr paramBlock );

Параметры


      paramBlock

Указатель на основной блок параметра HFS. Посмотрите HParamBlockRec для описания HParamBlockRec тип данных.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера. Когда PBMakeFSSpecSync возвраты любой результат кроме noErr или fnfErr, все поля получающегося FSSpec структура установлена в 0.

Обсуждение

Соответствующие поля блока параметра:

`ioNamePtr`	На вводе, указателе на полный или частичный путь, указывающий файл или каталог, для которого можно создать `FSSpec`. Если `ioNamePtr` поле указывает полный путь, `PBMakeFSSpecSync` игнорирует обоих `ioVRefNum` и `ioDirID` поля. Частичный путь мог бы идентифицировать только заключительную цель, или это могло бы включать одно или более имен родительского каталога. Если `ioNamePtr` указывает частичный путь, тогда `ioVRefNum`, `ioDirID`, или оба должны быть допустимыми.
`ioVRefNum`	На вводе, спецификации объема для объема, содержащего файл или каталог. Это поле может содержать ссылочный номер объема, число диска, или 0 для указания объема по умолчанию.
`ioMisc`	На вводе, указателе на `FSSpec` структура. Учитывая полную спецификацию для файла или каталога, `PBMakeFSSpecSync` функция заполняет это `FSSpec` структура для идентификации файла или каталога. На выводе это поле указывает на инициализированный `FSSpec`. Структура спецификации файловой системы, которую Вы передаете в этом поле, не должна совместно использовать пространство памяти с входным путем; `name` поле может быть инициализировано к пустой строке, прежде чем был обработан путь. Например, `ioNamePtr` не должен относиться к `name` поле системной спецификации выходного файла.
`ioDirID`	На вводе, каталоге ID. Это поле обычно указывает родительский каталог ID целевого объекта. Если каталог достаточно указан `ioNamePtr` поле, `ioDirID` поле может быть установлено в 0. Если `ioNamePtr` поле содержит пустую строку, `PBMakeFSSpecSync` создает `FSSpec` структура для каталога, указанного `ioDirID` поле.

Если указанный объем смонтирован, и указанный родительский каталог существует, но конечный файл или каталог не существуют в том расположении, PBMakeFSSpecSync заполняет структуру и возвраты fnfErr вместо noErr. Структура допустима, но она описывает не существующую цель. Можно использовать структуру для другой работы, такой как создание файла.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    PBMakeFSSpecAsync
    PBMakeFSSpecAsync

(OS X v10.4)

Создает FSSpec структура для файла или каталога.

Оператор осуждения

Использовать PBMakeFSRefUnicodeAsync вместо этого.

Объявление

Objective C

OSErr PBMakeFSSpecAsync ( HParmBlkPtr paramBlock );

Параметры


      paramBlock

Указатель на основной блок параметра HFS. Посмотрите HParamBlockRec для описания HParamBlockRec тип данных.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Если указанный объем смонтирован, и указанный родительский каталог существует, но конечный файл или каталог не существуют в том расположении, PBMakeFSSpecAsync заполняет структуру и возвраты fnfErr вместо noErr. Структура допустима, но она описывает не существующую цель. Можно использовать структуру для другой работы, такой как создание файла.

PBMakeFSSpecAsync может возвратить много различных кодов ошибки Файлового менеджера. Когда PBMakeFSSpecAsync возвраты любой результат кроме noErr или fnfErr, все поля получающегося FSSpec структура установлена в 0.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции. Когда `PBMakeFSSpecAsync` возвраты любой результат кроме `noErr` или `fnfErr`, все поля получающегося `FSSpec` структура установлена в 0. См. “Коды Результата Файлового менеджера”.
`ioNamePtr`	На вводе, указателе на полный или частичный путь, указывающий файл или каталог, для которого можно создать `FSSpec`. Если `ioNamePtr` поле указывает полный путь, `PBMakeFSSpecAsync` игнорирует обоих `ioVRefNum` и `ioDirID` поля. Частичный путь мог бы идентифицировать только заключительную цель, или это могло бы включать одно или более имен родительского каталога. Если `ioNamePtr` указывает частичный путь, тогда `ioVRefNum`, `ioDirID`, или оба должны быть допустимыми.
`ioVRefNum`	На вводе, спецификации объема для объема, содержащего файл или каталог. Это поле может содержать ссылочный номер объема, число диска, или 0 для указания объема по умолчанию.
`ioMisc`	На вводе, указателе на `FSSpec` структура. Учитывая полную спецификацию для файла или каталога, `PBMakeFSSpecAsync` функция заполняет это `FSSpec` структура для идентификации файла или каталога. На выводе это поле указывает на инициализированный `FSSpec`. Структура спецификации файловой системы, которую Вы передаете в этом поле, не должна совместно использовать пространство памяти с входным путем; `name` поле может быть инициализировано к пустой строке, прежде чем был обработан путь. Например, `ioNamePtr` не должен относиться к `name` поле системной спецификации выходного файла.
`ioDirID`	На вводе, каталоге ID. Это поле обычно указывает родительский каталог ID целевого объекта. Если каталог достаточно указан `ioNamePtr` поле, `ioDirID` поле может быть установлено в 0. Если `ioNamePtr` поле содержит пустую строку, `PBMakeFSSpecAsync` создает `FSSpec` структура для каталога, указанного `ioDirID` поле.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.

Создание файлов

FSCreateFileAndOpenForkUnicode FSCreateFileAndOpenForkUnicode (OS X v10.8)

Создает новый файл и открывает указанное ветвление.

Оператор осуждения

На уровне Foundation использовать createFileAtPath:contents:attributes: или writeToFile:options:error: вместо этого. На уровне POSIX/BSD использовать open(2) OS X Developer Tools Manual Page с O_CREAT и O_EXCL флаги вместо этого.

Объявление

Objective C

OSStatus FSCreateFileAndOpenForkUnicode ( const FSRef *parentRef, UniCharCount nameLength, const UniChar *name, FSCatalogInfoBitmap whichInfo, const FSCatalogInfo *catalogInfo, UniCharCount forkNameLength, const UniChar *forkName, SInt8 permissions, FSIORefNum *forkRefNum, FSRef *newRef );

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.4 и позже.
Осуждаемый в OS X v10.8.


    
    FSCreateFileUnicode
    FSCreateFileUnicode

(OS X v10.8)

Создает новый файл с именем Unicode.

Оператор осуждения

На уровне Foundation использовать createFileAtPath:contents:attributes: или writeToFile:options:error: вместо этого. На уровне POSIX/BSD использовать open(2) OS X Developer Tools Manual Page с O_CREAT и O_EXCL флаги вместо этого.

Объявление

Objective C

OSErr FSCreateFileUnicode ( const FSRef *parentRef, UniCharCount nameLength, const UniChar *name, FSCatalogInfoBitmap whichInfo, const FSCatalogInfo *catalogInfo, FSRef *newRef, FSSpecPtr newSpec );

Параметры

`parentRef`	Указатель на `FSRef` для каталога, где должен быть создан файл. Посмотрите `FSRef` для описания `FSRef` тип данных.
`nameLength`	Длина имени файла.
`name`	Указатель на Unicode называет для нового файла.
`whichInfo`	Битовый массив, указывающий, который поля информации о каталоге установить для нового файла. Вы указываете значения для этих полей в `catalogInfo` параметр. Если Вы не хотите устанавливать информацию о каталоге для нового файла, передайте константу `kFSCatInfoNone`. Посмотрите Растровые Константы информации о Каталоге для описания битов, определенных для этого параметра.
`catalogInfo`	Указатель на `FSCatalogInfo` структура, указывающая значения информации о каталоге нового файла. Укажите который поля начаться `whichInfo` параметр. Этот параметр является дополнительным; указать `NULL` если Вы не хотите устанавливать информацию о каталоге для нового файла.
`newRef`	По возврату, указателю на `FSRef` для нового файла. Если Вы не хотите `FSRef` возвращенный, указать `NULL`.
`newSpec`	По возврату, указателю на `FSSpec` для нового файла. Если Вы не хотите `FSSpec` возвращенный, указать `NULL`. Посмотрите `FSSpec` для описания `FSSpec` тип данных.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Можно дополнительно установить информацию о каталоге для нового файла с помощью whichInfo и catalogInfo параметры; это эквивалентно вызову FSSetCatalogInfo , или один из соответствующего параметра блокирует функции, PBSetCatalogInfoSync и PBSetCatalogInfoAsync , после создания файла.

Специальные замечания

Если FSCreateFileUnicode функция присутствует, но не реализована определенным объемом, Файловый менеджер будет эмулировать эту функцию путем совершения надлежащего звонка к PBHCreateSync. Однако, если функция не будет непосредственно поддерживаться объемом, то Вы не будете в состоянии использовать долгие имена файлов Unicode или другие опции, добавленные с HFS Плюс.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    FSpCreate
    FSpCreate

(OS X v10.4)

Создает новый файл.

Оператор осуждения

Использовать FSCreateFileUnicode вместо этого.

Объявление

Objective C

OSErr FSpCreate ( const FSSpec *spec, OSType creator, OSType fileType, ScriptCode scriptTag );

Параметры

`spec`	Указатель на `FSSpec` структура, указывающая файл, который будет создаваться. Посмотрите `FSSpec` для описания `FSSpec` тип данных.
`creator`	Создатель нового файла. См. документацию для Интерфейса Средства поиска для получения дополнительной информации о создателях файла.
`fileType`	Тип файла нового файла. См. документацию для Интерфейса Средства поиска для получения дополнительной информации о типах файлов.
`scriptTag`	Код системы сценария, в которой должно быть выведено на экран имя файла. Если Вы установили название и местоположение нового файла с помощью любого `NavAskSaveChanges` или `NavCustomAskSaveChanges` функционируйте, укажите, что код сценария возвратился в структуре ответа. Иначе, укажите системный сценарий путем установки `scriptTag` параметр к значению `smSystemScript`. Для получения дополнительной информации о функциях `NavAskSaveChanges` и `NavCustomAskSaveChanges`, посмотрите Программирование С Navigation Services. Посмотрите менеджера по Сценарию Референса по описанию `smSystemScript` постоянный.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

FSpCreate функция создает новый файл (и ветви данных и ветви ресурсов) с указанным типом, создателем и кодом сценария. Новый файл разблокирован и пуст. Дата и время создания и последнего изменения установлена в текущую дату и время.

Файлы создали использование FSpCreate автоматически не открыты. Если Вы хотите записать данные в новый файл, необходимо сначала открыть файл с помощью одной из функций доступа к файлу, FSpOpenDF , HOpenDF , PBHOpenDFSync или PBHOpenDFAsync.

Ветвь ресурсов нового файла существует, но пуста. Необходимо будет вызвать одну из функций Менеджера ресурсов HCreateResFile или FSpCreateResFile создать карту ресурса в файле, прежде чем можно будет открыть его путем вызывания одной из функций Менеджера ресурсов HOpenResFile или FSpOpenResFile).

Прежде, чем вызвать эту функцию, необходимо вызвать Gestalt функционируйте, чтобы проверить, что функция доступна. Если FSpCreate не доступно, можно использовать функцию HCreate вместо этого. Для создания файла с именем файла Unicode используйте функцию FSCreateFileUnicode , или один из соответствующего параметра блокирует вызовы, PBCreateFileUnicodeSync и PBCreateFileUnicodeAsync.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    HCreate
    HCreate

(OS X v10.4)

Создает новый файл.

Оператор осуждения

Использовать FSCreateFileUnicode вместо этого.

Объявление

Objective C

OSErr HCreate ( FSVolumeRefNum vRefNum, SInt32 dirID, ConstStr255Param fileName, OSType creator, OSType fileType );

Параметры

`vRefNum`	Ссылочный номер объема, управляйте числом, или 0 для объема по умолчанию.
`dirID`	Каталог ID каталога, в котором можно создать новый файл.
`fileName`	Имя нового файла. Это может быть полным или частичным путем. Вы не должны позволять пользователям давать имена файлов, начинающиеся с периода (.). Это гарантирует, что файлы могут быть успешно открыты вызовом приложений `HOpen` вместо `HOpenDF`.
`creator`	Создатель нового файла. Для получения дополнительной информации о создателе файла см. документацию Интерфейса Средства поиска.
`fileType`	Тип файла нового файла. Для получения дополнительной информации о типе файла см. документацию Интерфейса Средства поиска.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

HCreate функция создает новый файл (и ветви данных и ветви ресурсов) с указанным именем, создателем и типом файла. Новый файл разблокирован и пуст. Дата и время его создания и последнего изменения установлена в текущую дату и время.

Файлы создали использование HCreate автоматически не открыты. Если Вы хотите записать данные в новый файл, необходимо сначала открыть файл с помощью функции доступа к файлу.

Ветвь ресурсов нового файла существует, но пуста. Необходимо будет вызвать одну из функций Менеджера ресурсов HCreateResFile или FSpCreateResFile создать карту ресурса в файле, прежде чем можно будет открыть его (путем вызывания одной из функций Менеджера ресурсов HOpenResFile или FSpOpenResFile).

Для создания файла с именем файла Unicode используйте функцию FSCreateFileUnicode , или один из соответствующего параметра блокирует вызовы, PBCreateFileUnicodeSync и PBCreateFileUnicodeAsync.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    PBCreateFileUnicodeSync
    PBCreateFileUnicodeSync

(OS X v10.8)

Создает новый файл с именем Unicode.

Оператор осуждения

Объявление

Objective C

OSErr PBCreateFileUnicodeSync ( FSRefParam *paramBlock );

Параметры


      paramBlock

Указатель на блок параметра ссылки файловой системы. Посмотрите FSRefParam для описания FSRefParam тип данных.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ref`	На вводе, указателе на `FSRef` для каталога, где должен быть создан файл.
`nameLength`	На вводе, числе символов Unicode на имя файла.
`name`	На вводе, указателе на имя Unicode нового файла.
`whichInfo`	На вводе, битовый массив, указывающий, который поля информации о каталоге установить для нового файла. Укажите значения для этих полей в `catInfo` поле. Если Вы не хотите устанавливать информацию о каталоге для нового файла, передайте константу `kFSCatInfoNone` здесь. Посмотрите Растровые Константы информации о Каталоге для описания битов, определенных для этого поля.
`catInfo`	На вводе, указателе на `FSCatalogInfo` структура, указывающая значения полей информации о каталоге нового файла. Укажите который поля начаться `whichInfo` поле. Это поле является дополнительным; указать `NULL` если Вы не хотите устанавливать информацию о каталоге для нового файла.
`newRef`	На выводе, указателе на `FSRef` для нового файла. Если Вы не хотите `FSRef` возвращенный, устанавливает это поле в `NULL` на вводе.
`spec`	На выводе, указателе на `FSSpec` для нового файла. Если Вы не хотите `FSSpec` возвращенный, устанавливает это поле в `NULL` на вводе.

Можно дополнительно установить информацию о каталоге для нового файла с помощью whichInfo и catInfo поля; это эквивалентно вызову FSSetCatalogInfo , или один из соответствующего параметра блокирует функции, PBSetCatalogInfoSync и PBSetCatalogInfoAsync , после создания файла.

Специальные замечания

Если PBCreateFileUnicodeSync функция присутствует, но не реализована определенным объемом, Файловый менеджер будет эмулировать эту функцию путем совершения надлежащего звонка к PBHCreateSync. Однако, если функция не будет непосредственно поддерживаться объемом, то Вы не будете в состоянии использовать долгие имена файлов Unicode или другие опции, добавленные с HFS Плюс.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    PBCreateFileUnicodeAsync
    PBCreateFileUnicodeAsync

(OS X v10.8)

Создает новый файл с именем Unicode.

Оператор осуждения

Объявление

Objective C

void PBCreateFileUnicodeAsync ( FSRefParam *paramBlock );

Параметры


      paramBlock

Указатель на блок параметра ссылки файловой системы. Посмотрите FSRefParam для описания FSRefParam тип данных.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции. См. “Коды Результата Файлового менеджера”.
`ref`	На вводе, указателе на `FSRef` для каталога, где должен быть создан файл.
`nameLength`	На вводе, числе символов Unicode на имя файла.
`name`	На вводе, указателе на имя Unicode нового файла.
`whichInfo`	На вводе, битовый массив, указывающий, который поля информации о каталоге установить для нового файла. Укажите значения для этих полей в `catInfo` поле. Если Вы не хотите устанавливать информацию о каталоге для нового файла, передайте константу `kFSCatInfoNone` здесь. Посмотрите Растровые Константы информации о Каталоге для описания битов, определенных для этого поля.
`catInfo`	На вводе, указателе на `FSCatalogInfo` структура, указывающая значения полей информации о каталоге нового файла. Укажите который поля начаться `whichInfo` поле. Это поле является дополнительным; указать `NULL` если Вы не хотите устанавливать информацию о каталоге для нового файла.
`newRef`	На выводе, указателе на `FSRef` для нового файла. Если Вы не хотите `FSRef` возвращенный, передача `NULL` на вводе.
`spec`	На выводе, указателе на `FSSpec` для нового файла. Если Вы не хотите `FSSpec` возвращенный, передача `NULL` на вводе.

Можно дополнительно установить информацию о каталоге для файла с помощью whichInfo и catInfo поля; это эквивалентно вызову FSSetCatalogInfo , или один из соответствующего параметра блокирует функции, PBSetCatalogInfoSync и PBSetCatalogInfoAsync , после создания файла.

Специальные замечания

Если PBCreateFileUnicodeAsync функция присутствует, но не реализована определенным объемом, Файловый менеджер будет эмулировать эту функцию путем совершения надлежащего звонка к PBHCreateAsync. Однако, если функция не будет непосредственно поддерживаться объемом, то Вы не будете в состоянии использовать долгие имена файлов Unicode или другие опции, добавленные с HFS Плюс.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    PBHCreateSync
    PBHCreateSync

(OS X v10.4)

Создает новый файл.

Оператор осуждения

Использовать PBCreateFileUnicodeSync вместо этого.

Объявление

Objective C

OSErr PBHCreateSync ( HParmBlkPtr paramBlock );

Параметры


      paramBlock

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioNamePtr`	На вводе, указателе на имя для нового файла.
`ioVRefNum`	На вводе, ссылочном номере объема, числе диска, или 0 для объема по умолчанию.
`ioDirID`	На вводе, каталоге ID родительского каталога нового файла.
`ioFVersNum`	На вводе это поле должно быть инициализировано для обнуления; если это поле не будет нулем, то вызов провалится к теперь устаревшему коду Macintosh File System (MFS), если объем получил доступ, объем MFS.

PBHCreateSync функция создает и ветвь данных и ветвь ресурсов файла, новый файл разблокирован и пуст. Дата и время его создания и последнего изменения установлена в текущую дату и время. Если создаваемый файл не является временным (т.е. если он будет существовать после того, как пользователь выходит из приложения), приложение должно вызвать PBHSetFInfoSync после вызова к PBHCreateSync заполнить информацию, необходимую Средству поиска.

Файлы создали использование PBHCreateSync автоматически не открыты. Если Вы хотите записать данные в новый файл, необходимо сначала открыть файл с помощью одной из функций доступа к файлу, FSpOpenDF , HOpenDF , PBHOpenDFSync или PBHOpenDFAsync.

Ветвь ресурсов нового файла существует, но пуста. Необходимо будет вызвать одну из процедур Менеджера ресурсов HCreateResFile или FSpCreateResFile создать карту ресурса в файле, прежде чем можно будет открыть его (путем вызывания одной из функций Менеджера ресурсов HOpenResFile или FSpOpenResFile).

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    PBHCreateAsync
    PBHCreateAsync

(OS X v10.4)

Создает новый файл.

Оператор осуждения

Использовать PBCreateFileUnicodeAsync вместо этого.

Объявление

Objective C

OSErr PBHCreateAsync ( HParmBlkPtr paramBlock );

Параметры


      paramBlock

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на функцию завершения. Для получения дополнительной информации о функциях завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции.
`ioNamePtr`	На вводе, указателе на имя для нового файла.
`ioVRefNum`	На вводе, ссылочном номере объема, числе диска, или 0 для объема по умолчанию.
`ioDirID`	На вводе, каталоге ID родительского каталога нового файла.
`ioFVersNum`	На вводе это поле должно быть инициализировано для обнуления; если это поле не будет нулем, то вызов провалится к теперь устаревшему коду Macintosh File System (MFS), если объем получил доступ, объем MFS.

PBHCreateAsync функция создает оба ветвления файла, новый файл разблокирован и пуст. Дата и время его создания и последнего изменения установлена в текущую дату и время. Если создаваемый файл не является временным (т.е. если он будет существовать после того, как пользователь выходит из приложения), приложение должно вызвать PBHSetFInfoAsync , после вызова к PBHCreateAsync, заполнить информацию, необходимую Средству поиска.

Файлы создали использование PBHCreateAsync автоматически не открыты. Если Вы хотите записать данные в новый файл, необходимо сначала открыть файл с помощью одной из функций доступа к файлу, FSpOpenDF , HOpenDF , PBHOpenDFSync или PBHOpenDFAsync.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.

Создание, вызывая и удаляя Универсальные указатели процедуры


    
    NewIOCompletionUPP
    NewIOCompletionUPP

(OS X v10.8)

Создает новый универсальный указатель процедуры (UPP) к Вашей функции обратного вызова завершения I/O.

Объявление

Objective C

IOCompletionUPP NewIOCompletionUPP ( IOCompletionProcPtr userRoutine );

Параметры


      userRoutine

Указатель на Вашу функцию обратного вызова завершения I/O. Для получения дополнительной информации посмотрите IOCompletionProcPtr.

Возвращаемое значение

UPP к Вашей функции обратного вызова завершения I/O.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    NewFNSubscriptionUPP
    NewFNSubscriptionUPP

(OS X v10.8)

Создает новый универсальный указатель процедуры (UPP) к Вашей функции обратного вызова изменения каталога.

Объявление

Objective C

FNSubscriptionUPP NewFNSubscriptionUPP ( FNSubscriptionProcPtr userRoutine );

Параметры


      userRoutine

Указатель на каталог изменяет функцию обратного вызова. Для получения дополнительной информации посмотрите FNSubscriptionProcPtr.

Возвращаемое значение

UPP к Вашему каталогу изменяет функцию обратного вызова.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.1 и позже.

Осуждаемый в OS X v10.8.


    
    NewFSVolumeEjectUPP
    NewFSVolumeEjectUPP

(OS X v10.8)

Создает новый универсальный указатель процедуры (UPP) к Вашей функции обратного вызова извлечения объема.

Объявление

Objective C

FSVolumeEjectUPP NewFSVolumeEjectUPP ( FSVolumeEjectProcPtr userRoutine );

Параметры


      userRoutine

Указатель на функцию обратного вызова извлечения объема. Для получения дополнительной информации посмотрите FSVolumeEjectProcPtr.

Возвращаемое значение

UPP к Вашей функции обратного вызова извлечения объема.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.2 и позже.

Осуждаемый в OS X v10.8.


    
    NewFSVolumeMountUPP
    NewFSVolumeMountUPP

(OS X v10.8)

Создает новый универсальный указатель процедуры (UPP) к Вашему объему, монтируют функцию обратного вызова.

Объявление

Objective C

FSVolumeMountUPP NewFSVolumeMountUPP ( FSVolumeMountProcPtr userRoutine );

Параметры


      userRoutine

Указатель на объем монтирует функцию обратного вызова. Для получения дополнительной информации посмотрите FSVolumeEjectProcPtr.

Возвращаемое значение

UPP к Вашему объему монтирует функцию обратного вызова.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.2 и позже.

Осуждаемый в OS X v10.8.


    
    NewFSVolumeUnmountUPP
    NewFSVolumeUnmountUPP

(OS X v10.8)

Создает новый универсальный указатель процедуры (UPP) к Вашей функции обратного вызова размонтирования объема.

Объявление

Objective C

FSVolumeUnmountUPP NewFSVolumeUnmountUPP ( FSVolumeUnmountProcPtr userRoutine );

Параметры


      userRoutine

Указатель на объем размонтировал функцию обратного вызова. Для получения дополнительной информации посмотрите FSVolumeUnmountProcPtr.

Возвращаемое значение

UPP к Вашему объему размонтировал функцию обратного вызова.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.2 и позже.

Осуждаемый в OS X v10.8.

InvokeIOCompletionUPP InvokeIOCompletionUPP (OS X v10.8)

Вызывает Вашу функцию обратного вызова завершения I/O.

Объявление

Objective C

void InvokeIOCompletionUPP ( ParmBlkPtr paramBlock, IOCompletionUPP userUPP );

Обсуждение

Файловый менеджер вызывает эту функцию для вызова функции завершения I/O, которая Вы предусмотрели использование после того, как был завершен асинхронный вызов. Вы не должны должны быть использовать эту функцию сами. Для получения дополнительной информации о функциях завершения I/O посмотрите IOCompletionProcPtr.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.8.
InvokeFNSubscriptionUPP InvokeFNSubscriptionUPP (OS X v10.8)

Вызывает Вашу функцию обратного вызова изменения каталога.

Объявление

Objective C

void InvokeFNSubscriptionUPP ( FNMessage message, OptionBits flags, void *refcon, FNSubscriptionRef subscription, FNSubscriptionUPP userUPP );

Обсуждение

Файловый менеджер вызывает эту функцию для вызова функции изменения каталога, которая Вы предусмотрели использование после того, как был завершен асинхронный вызов. Вы не должны должны быть использовать эту функцию сами. Для получения дополнительной информации о функциях изменения каталога посмотрите FNSubscriptionProcPtr.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.1 и позже.
Осуждаемый в OS X v10.8.
InvokeFSVolumeEjectUPP InvokeFSVolumeEjectUPP (OS X v10.8)

Вызывает Вашу функцию обратного вызова извлечения объема.

Объявление

Objective C

void InvokeFSVolumeEjectUPP ( FSVolumeOperation volumeOp, void *clientData, OSStatus err, FSVolumeRefNum volumeRefNum, pid_t dissenter, FSVolumeEjectUPP userUPP );

Обсуждение

Файловый менеджер вызывает эту функцию для вызова функции извлечения объема, которая Вы предусмотрели использование после того, как был завершен асинхронный вызов. Вы не должны должны быть использовать эту функцию сами. Для получения дополнительной информации о функциях уведомления изменения посмотрите FSVolumeEjectProcPtr.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.2 и позже.
Осуждаемый в OS X v10.8.
InvokeFSVolumeMountUPP InvokeFSVolumeMountUPP (OS X v10.8)

Вызовы Ваш объем монтируют функцию обратного вызова.

Объявление

Objective C

void InvokeFSVolumeMountUPP ( FSVolumeOperation volumeOp, void *clientData, OSStatus err, FSVolumeRefNum mountedVolumeRefNum, FSVolumeMountUPP userUPP );

Обсуждение

Файловый менеджер вызывает эту функцию для вызова объема, монтируют функцию, которая Вы предусмотрели использование после того, как был завершен асинхронный вызов. Вы не должны должны быть использовать эту функцию сами. Для получения дополнительной информации о функциях уведомления изменения посмотрите FSVolumeMountProcPtr.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.2 и позже.
Осуждаемый в OS X v10.8.
InvokeFSVolumeUnmountUPP InvokeFSVolumeUnmountUPP (OS X v10.8)

Вызывает Вашу функцию обратного вызова размонтирования объема.

Объявление

Objective C

void InvokeFSVolumeUnmountUPP ( FSVolumeOperation volumeOp, void *clientData, OSStatus err, FSVolumeRefNum volumeRefNum, pid_t dissenter, FSVolumeUnmountUPP userUPP );

Обсуждение

Файловый менеджер вызывает эту функцию для вызова функции размонтирования объема, которая Вы предусмотрели использование после того, как был завершен асинхронный вызов. Вы не должны должны быть использовать эту функцию сами. Для получения дополнительной информации о функциях уведомления изменения посмотрите FSVolumeUnmountProcPtr.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.2 и позже.
Осуждаемый в OS X v10.8.
DisposeIOCompletionUPP DisposeIOCompletionUPP (OS X v10.8)

Удаляет универсальный указатель процедуры (UPP) к Вашей функции обратного вызова завершения I/O.

Объявление

Objective C

void DisposeIOCompletionUPP ( IOCompletionUPP userUPP );

Параметры

userUPP

UPP для удаления.

Обсуждение

Необходимо использовать эту функцию для удаления UPP после того, как Файловый менеджер будет закончен, вызывая функцию обратного вызова завершения I/O.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.8.
DisposeFNSubscriptionUPP DisposeFNSubscriptionUPP (OS X v10.8)

Удаляет универсальный указатель процедуры (UPP) к Вашей функции обратного вызова изменения каталога.

Объявление

Objective C

void DisposeFNSubscriptionUPP ( FNSubscriptionUPP userUPP );

Параметры

userUPP

UPP для удаления.

Обсуждение

Необходимо использовать эту функцию для удаления UPP после того, как Файловый менеджер будет закончен, вызывая функцию обратного вызова изменения каталога.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.1 и позже.
Осуждаемый в OS X v10.8.
DisposeFSVolumeEjectUPP DisposeFSVolumeEjectUPP (OS X v10.8)

Удаляет универсальный указатель процедуры (UPP) к Вашей функции обратного вызова извлечения объема.

Объявление

Objective C

void DisposeFSVolumeEjectUPP ( FSVolumeEjectUPP userUPP );

Параметры

userUPP

UPP для удаления.

Обсуждение

Необходимо использовать эту функцию для удаления UPP после того, как Файловый менеджер будет закончен, вызывая функцию обратного вызова извлечения объема.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.2 и позже.
Осуждаемый в OS X v10.8.
DisposeFSVolumeMountUPP DisposeFSVolumeMountUPP (OS X v10.8)

Удаляет универсальный указатель процедуры (UPP) к Вашему объему, монтируют функцию обратного вызова.

Объявление

Objective C

void DisposeFSVolumeMountUPP ( FSVolumeMountUPP userUPP );

Параметры

userUPP

UPP для удаления.

Обсуждение

Необходимо использовать эту функцию для удаления UPP после того, как Файловый менеджер закончен, вызвав объем, монтируют функцию обратного вызова.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.2 и позже.
Осуждаемый в OS X v10.8.
DisposeFSVolumeUnmountUPP DisposeFSVolumeUnmountUPP (OS X v10.8)

Удаляет универсальный указатель процедуры (UPP) к Вашей функции обратного вызова размонтирования объема.

Объявление

Objective C

void DisposeFSVolumeUnmountUPP ( FSVolumeUnmountUPP userUPP );

Параметры

userUPP

UPP для удаления.

Обсуждение

Необходимо использовать эту функцию для удаления UPP после того, как Файловый менеджер будет закончен, вызывая функцию обратного вызова размонтирования объема.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.2 и позже.
Осуждаемый в OS X v10.8.

Удаление файлов и каталогов


    
    FSDeleteObject
    FSDeleteObject

(OS X v10.8)

Удаляет файл или пустой каталог.

Оператор осуждения

На уровне Foundation использовать removeItemAtURL:error: вместо этого. На уровне POSIX/BSD использовать rmdir(2) OS X Developer Tools Manual Page для каталогов, или unlink(2) OS X Developer Tools Manual Page для файлов, вместо этого.

Объявление

Objective C

OSErr FSDeleteObject ( const FSRef *ref );

Параметры

ref

Указатель на FSRef указание файла или каталога, который будет удален. Если объект, который будет удален, является каталогом, это должно быть пусто (это не должно содержать файлы или папки). Посмотрите FSRef для описания FSRef тип данных.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера. При попытке удалить папку, для которой существует открытый итератор каталога, эта функция успешно выполняется и возвращается noErr. Итерация, однако, будет продолжать работать, пока итератор не закрывается.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    PBDeleteObjectSync
    PBDeleteObjectSync

(OS X v10.8)

Удаляет файл или пустой каталог.

Оператор осуждения

Объявление

Objective C

OSErr PBDeleteObjectSync ( FSRefParam *paramBlock );

Параметры


      paramBlock

Указатель на блок параметра ссылки файловой системы. Посмотрите FSRefParam для описания FSRefParam тип данных.

Возвращаемое значение

Обсуждение

Соответствующее поле блока параметра:

ref

На вводе, указателе на FSRef для файла или каталога, который будет удален. Если объект, который будет удален, является каталогом, это должно быть пусто (это не должно содержать файлы или папки).

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    PBDeleteObjectAsync
    PBDeleteObjectAsync

(OS X v10.8)

Удаляет файл или пустой каталог.

Оператор осуждения

Объявление

Objective C

void PBDeleteObjectAsync ( FSRefParam *paramBlock );

Параметры


      paramBlock

Указатель на блок параметра ссылки файловой системы. Посмотрите FSRefParam для описания FSRefParam тип данных.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	Код результата. Посмотрите Коды Результата Файлового менеджера. При попытке удалить папку, для которой существует открытый итератор каталога, эта функция успешно выполняется и возвращается `noErr`. Итерация, однако, будет продолжать работать, пока итератор не закрывается.
`ref`	На вводе, указателе на `FSRef` для файла или каталога, который будет удален. Если объект, который будет удален, является каталогом, это должно быть пусто (это не должно содержать файлы или папки).

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    FSpDelete
    FSpDelete

(OS X v10.4)

Удаляет файл или каталог.

Оператор осуждения

Использовать FSDeleteObject вместо этого.

Объявление

Objective C

OSErr FSpDelete ( const FSSpec *spec );

Параметры


      spec

Указатель на FSSpec структура, указывающая файл или каталог для удаления. Посмотрите FSSpec для описания FSSpec тип данных.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера. При попытке удалить открытый файл или непустой каталог, FSpDelete возвращает код результата fBsyErr. FSpDelete также возвращает код результата fBsyErr если каталог имеет открытый рабочий каталог, связанный с ним.

Обсуждение

Если указанная цель является файлом, оба ветвления файла удалены. Ссылка идентификатора файла, если таковые имеются, удалена. Файл должен быть закрыт, прежде чем можно будет удалить его. Точно так же каталог должен быть пустым, прежде чем можно будет удалить его.

Прежде, чем вызвать эту функцию, необходимо вызвать Gestalt функционируйте, чтобы проверить, что функция доступна. Если FSpDelete не доступно, можно использовать функцию HDelete вместо этого.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    HDelete
    HDelete

(OS X v10.4)

Удаляет файл или каталог.

Оператор осуждения

Использовать FSDeleteObject вместо этого.

Объявление

Objective C

OSErr HDelete ( FSVolumeRefNum vRefNum, SInt32 dirID, ConstStr255Param fileName );

Параметры

`vRefNum`	Ссылочный номер объема, управляйте числом, или 0 для объема по умолчанию.
`dirID`	Каталог ID родительского каталога файла или каталога для удаления.
`fileName`	Имя файла или каталога для удаления. Это может быть полным или частичным путем.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера. При попытке удалить открытый файл или непустой каталог, HDelete возвращает код результата fBsyErr. HDelete также возвращает код результата fBsyErr если каталог имеет открытый рабочий каталог, связанный с ним.

Обсуждение

Если указанная цель является файлом, и данные и ветвь ресурсов файла удалены. Кроме того, если ссылка идентификатора файла для указанного файла существует, та ссылка удалена. Файл должен быть закрыт, прежде чем можно будет удалить его. Точно так же Вы не можете удалить каталог, если это не пусто.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    PBHDeleteSync
    PBHDeleteSync

(OS X v10.4)

Удаляет файл или каталог.

Оператор осуждения

Использовать PBDeleteObjectSync вместо этого.

Объявление

Objective C

OSErr PBHDeleteSync ( HParmBlkPtr paramBlock );

Параметры


      paramBlock

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера. При попытке удалить открытый файл или непустой каталог, PBHDeleteSync возвращает код результата fBsyErr. PBHDeleteSync также возвраты fBsyErr при попытке удалить каталог, имеющий открытый рабочий каталог, связанный с ним.

Обсуждение

Соответствующие поля блока параметра:

`ioNamePtr`	На вводе, указателе на имя файла или каталога для удаления.
`ioVRefNum`	На вводе, ссылочном номере объема, числе диска, или 0 для объема по умолчанию.
`ioDirID`	На вводе, каталоге ID родительского каталога файла или каталога для удаления.
`ioFVersNum`	На вводе это поле должно быть инициализировано для обнуления; если это поле не будет нулем, то вызов провалится к теперь устаревшему коду Macintosh File System (MFS), если объем получил доступ, объем MFS.

Если указанная цель является файлом, и данные и ветвь ресурсов файла удалены. Кроме того, если ссылка идентификатора файла для указанного файла существует, та ссылка идентификатора файла также удалена. Файл должен быть закрыт, прежде чем можно будет удалить его. Точно так же Вы не можете удалить каталог, если это не пусто.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    PBHDeleteAsync
    PBHDeleteAsync

(OS X v10.4)

Удаляет файл или каталог.

Оператор осуждения

Использовать PBDeleteObjectAsync вместо этого.

Объявление

Objective C

OSErr PBHDeleteAsync ( HParmBlkPtr paramBlock );

Параметры


      paramBlock

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на функцию завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции. При попытке удалить открытый файл или непустой каталог, `PBHDeleteAsync` возвращает код результата `fBsyErr`. `PBHDeleteAsync` также возвраты `fBsyErr` при попытке удалить каталог, имеющий открытый рабочий каталог, связанный с ним.
`ioNamePtr`	На вводе, указателе на имя файла или каталога для удаления.
`ioVRefNum`	На вводе, ссылочном номере объема, числе диска, или 0 для объема по умолчанию.
`ioDirID`	На вводе, каталоге ID родительского каталога файла или каталога для удаления.
`ioFVersNum`	На вводе это поле должно быть инициализировано для обнуления; если это поле не будет нулем, то вызов провалится к теперь устаревшему коду Macintosh File System (MFS), если объем получил доступ, объем MFS.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.

FSUnlinkObject FSUnlinkObject (OS X v10.8)

Расцепляет существующий файл или удаляет существующий каталог.

Оператор осуждения

На уровне Foundation использовать removeItemAtURL:error: вместо этого. На уровне POSIX/BSD использовать unlink вместо этого.

Объявление

Objective C

OSErr FSUnlinkObject ( const FSRef *ref );

Параметры

ref

Объект расцепить или удалить.

Возвращаемое значение

Код результата, указывающий успешность или неуспешность работы.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.8.

Определение имен Unicode ветвей данных и ветвей ресурсов


    
    FSGetDataForkName
    FSGetDataForkName

(OS X v10.8)

Возвращает строковую константу Unicode для имени ветви данных.

Объявление

Objective C

OSErr FSGetDataForkName ( HFSUniStr255 *dataForkName );

Параметры


      dataForkName

На вводе, указателе на HFSUniStr255 структура. По возврату эта структура содержит имя Unicode ветви данных. В настоящее время это - пустая строка. Посмотрите HFSUniStr255 для описания HFSUniStr255 тип данных.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Нет никакого параметра основанной на блоке формы этого вызова, так как это не диспетчеризируется отдельным форматам объема и не требует никакого I/O.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    FSGetResourceForkName
    FSGetResourceForkName

(OS X v10.8)

Возвращает строковую константу Unicode для имени ветви ресурсов.

Объявление

Objective C

OSErr FSGetResourceForkName ( HFSUniStr255 *resourceForkName );

Параметры


      resourceForkName

На вводе, указателе на HFSUniStr255 структура. По возврату эта структура содержит имя Unicode ветви ресурсов. В настоящее время это - «RESOURCE_FORK». Посмотрите HFSUniStr255 для описания HFSUniStr255 тип данных.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.

Обмен содержанием двух файлов


    
    FSExchangeObjects
    FSExchangeObjects

(OS X v10.8)

Подкачивает содержание двух файлов.

Оператор осуждения

На уровне Foundation использовать replaceItemAtURL:withItemAtURL:backupItemName:options:resultingItemURL:error: вместо этого.

Объявление

Objective C

OSErr FSExchangeObjects ( const FSRef *ref, const FSRef *destRef );

Параметры

`ref`	Указатель на `FSRef` для первого файла. Посмотрите `FSRef` для описания `FSRef` тип данных.
`destRef`	Указатель на `FSRef` для второго файла.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

FSExchangeObjects функция позволяет программам реализовывать “безопасное сохранение” работа путем создания и записи полного нового файла и свопинга содержания. Псевдоним, FSSpec, или FSRef это относится к старому файлу, теперь получит доступ к новым данным. Соответствующей информацией в структурах данных в памяти также обмениваются.

Или или оба файла могут иметь пути открытого доступа. После обмена путь доступа будет относиться к данным противоположного файла (т.е. к тем же данным, которые это первоначально отослало, который является теперь частью другого файла).

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    PBExchangeObjectsSync
    PBExchangeObjectsSync

(OS X v10.8)

Подкачивает содержание двух файлов.

Оператор осуждения

На уровне Foundation использовать replaceItemAtURL:withItemAtURL:backupItemName:options:resultingItemURL:error: вместо этого.

Объявление

Objective C

OSErr PBExchangeObjectsSync ( FSRefParam *paramBlock );

Параметры


      paramBlock

Указатель на блок параметра ссылки файловой системы. Посмотрите FSRefParam для описания FSRefParam тип данных.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ref`	На вводе, указателе на `FSRef` для первого файла.
`parentRef`	На вводе, указателе на `FSRef` для второго файла.

PBExchangeObjectsSync функция позволяет программам реализовывать “безопасное сохранение” работа путем создания и записи полного нового файла и свопинга содержания. Псевдоним, FSSpec, или FSRef это относится к старому файлу, теперь получит доступ к новым данным. Соответствующей информацией в структурах данных в памяти также обмениваются.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    PBExchangeObjectsAsync
    PBExchangeObjectsAsync

(OS X v10.8)

Подкачивает содержание двух файлов.

Оператор осуждения

На уровне Foundation использовать replaceItemAtURL:withItemAtURL:backupItemName:options:resultingItemURL:error: вместо этого.

Объявление

Objective C

void PBExchangeObjectsAsync ( FSRefParam *paramBlock );

Параметры


      paramBlock

Указатель на блок параметра ссылки файловой системы. Посмотрите FSRefParam для описания FSRefParam тип данных.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции.
`ref`	На вводе, указателе на `FSRef` для первого файла.
`parentRef`	На вводе, указателе на `FSRef` для второго файла.

PBExchangeObjectsAsync функция позволяет программам реализовывать “безопасное сохранение” работа путем создания и записи полного нового файла и свопинга содержания. Псевдоним, FSSpec, или FSRef это относится к старому файлу, теперь получит доступ к новым данным. Соответствующей информацией в структурах данных в памяти также обмениваются.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    FSpExchangeFiles
    FSpExchangeFiles

(OS X v10.4)

Обменивается данными, сохраненными в двух файлах на том же объеме.

Оператор осуждения

Использовать FSExchangeObjects вместо этого.

Объявление

Objective C

OSErr FSpExchangeFiles ( const FSSpec *source, const FSSpec *dest );

Параметры

`source`	Указатель на `FSSpec` для первого файла, который подкачает. Содержание этого файла и его информации о файле помещается в файл, указанный в `dest` параметр. Посмотрите `FSSpec` для описания `FSSpec` тип данных.
`dest`	Указатель на `FSSpec` для второго файла для свопинга. Содержание этого файла и его информации о файле помещается в файл, указанный в `source` параметр.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

FSpExchangeFiles функционируйте подкачивает данные в двух файлах путем изменения информации в каталоге объема и, если любой из файлов открыт в блоках управления файлом. Следующими полями в каталогизационных описаниях для файлов обмениваются:

ioFlStBlk
ioFlLgLen
ioFlPyLen
ioFlRStBlk
ioFlRLgLen
ioFlRPyLen
ioFlMdDat

В блоках управления файлом, fcbFlNum, fcbDirID, и fcbCName полями обмениваются.

Необходимо использовать FSpExchangeFiles при обновлении существующего файла, так, чтобы идентификатор файла остался допустимым в случае, если файл прослеживается через его идентификатор файла. FSpExchangeFiles функционируйте изменяет поля в каталогизационных описаниях, записывающих расположение данных и дат модификации. Это подкачивает и ветви данных и ветви ресурсов.

FSpExchangeFiles функционируйте работы и над открытыми и над закрытыми файлами. Если любой файл открыт, FSpExchangeFiles обновления любые блоки управления файлом связались с файлом. Обмен содержанием двух файлов требует по существу тех же прав доступа как открывающий оба файла для записи.

Файлы, данные которых должны быть переданы, должны оба находиться на том же объеме. Если они не делают, FSpExchangeFiles возвращает код результата diffVolErr.

Обмениваться содержанием файлов с именованными ветвлениями кроме ветвей данных и ветвей ресурсов, или файлов, больше, чем 2 ГБ, использование FSExchangeObjects , PBExchangeObjectsSync , или PBExchangeObjectsAsync функция.

Специальные замечания

“Совместимость кодирует”, который FSpExchangeFiles опробованный для выполнения самого обмена файла, если это подозревало, что базовая файловая система не имела возможности Exchange, был удален в Mac OS 9 и X.

Поскольку другие программы могут иметь пути доступа, открытые для одного или обоих из файлов, которыми обмениваются, Ваше приложение должно иметь монопольное разрешение доступа для чтения-записи (fsRdWrPerm) к обоим файлам перед вызовом FSpExchangeFiles. Монопольный доступ для чтения-записи к обоим файлам гарантирует это FSpExchangeFiles не влияет на другое приложение, потому что оно препятствует тому, чтобы другие приложения получили доступ для записи к одному или обоим из файлов, которыми обмениваются.

FSpExchangeFiles не уважает заблокированный файлом атрибут; даже если один или оба из файлов будут заблокированы, это выполнит обмен. Получение монопольного доступа для чтения-записи к обоим файлам перед вызовом FSpExchangeFiles гарантирует, что файлы разблокированы, потому что заблокированные файлы не могут быть открыты с доступом для записи.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    PBExchangeFilesSync
    PBExchangeFilesSync

(OS X v10.4)

Обменивается данными, сохраненными в двух файлах на том же объеме.

Оператор осуждения

Использовать PBExchangeObjectsSync вместо этого.

Объявление

Objective C

OSErr PBExchangeFilesSync ( HParmBlkPtr paramBlock );

Параметры


      paramBlock

Указатель на FIDParam вариант основного блока параметра HFS. Посмотрите HParamBlockRec для описания HParamBlockRec тип данных.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioNamePtr`	На вводе, указателе на имя первого файла, который подкачает.
`ioVRefNum`	На вводе, ссылочном номере объема, числе диска, или 0 для объема по умолчанию.
`ioDestNamePtr`	На вводе, указателе на имя второго файла для свопинга.
`ioDestDirID`	На вводе, родительский каталог второго файла ID.
`ioSrcDirID`	На вводе, родительский каталог первого файла ID.

Как правило, Вы используете PBExchangeFilesSync после создания нового файла во время безопасного сохранения. PBExchangeFilesSync функционируйте изменяет поля в каталогизационных описаниях, записывающих расположение данных и дат модификации. Это подкачивает и ветви данных и ветви ресурсов.

PBExchangeFilesSync функционируйте работы или над открытыми или над закрытыми файлами. PBExchangeFilesSync подкачивает данные в двух файлах путем изменения части информации в каталоге объема. Если любой файл открыт, PBExchangeFilesSync обновления любые блоки управления файлом связались с файлом. Обмен содержанием двух файлов требует по существу тех же прав доступа как открывающий оба файла для записи.

Следующими полями в каталогизационных описаниях для файлов обмениваются:

ioFlStBlk
ioFlLgLen
ioFlPyLen
ioFlRStBlk
ioFlRLgLen
ioFlRPyLen
ioFlMdDat

В блоках управления файлом, fcbFlNum, fcbDirID, и fcbCName полями обмениваются.

Необходимо использовать PBExchangeFilesSync сохранить идентификатор файла при обновлении существующего файла, в случае, если файл прослеживается через его идентификатор файла. PBExchangeFilesSync функция не требует, чтобы ссылки идентификатора файла существовали для файлов, которыми обмениваются.

Специальные замечания

Ваше приложение должно будет подкачать любые открытые ссылочные номера к двум файлам, потому что именем файла и родительским каталогом ID обмениваются в блоках управления файлом.

Поскольку другие программы могут иметь пути доступа, открытые для одного или обоих из файлов, которыми обмениваются, Ваше приложение должно иметь монопольное разрешение доступа для чтения-записи (fsRdWrPerm) к обоим файлам перед вызовом PBExchangeFilesSync. Монопольный доступ для чтения-записи к обоим файлам гарантирует это PBExchangeFilesSync не влияет на другое приложение, потому что оно препятствует тому, чтобы другие приложения получили доступ для записи к одному или обоим из файлов, которыми обмениваются.

PBExchangeFilesSync не уважает заблокированный файлом атрибут; даже если один или оба из файлов будут заблокированы, это выполнит обмен. Получение монопольного доступа для чтения-записи к обоим файлам перед вызовом PBExchangeFilesSync гарантирует, что файлы разблокированы, потому что заблокированные файлы не могут быть открыты с доступом для записи.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    PBExchangeFilesAsync
    PBExchangeFilesAsync

(OS X v10.4)

Обменивается данными, сохраненными в двух файлах на том же объеме.

Оператор осуждения

Использовать PBExchangeObjectsAsync вместо этого.

Объявление

Objective C

OSErr PBExchangeFilesAsync ( HParmBlkPtr paramBlock );

Параметры


      paramBlock

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции.
`ioNamePtr`	На вводе, указателе на имя первого файла, который подкачает.
`ioVRefNum`	На вводе, ссылочном номере объема, числе диска, или 0 для объема по умолчанию.
`ioDestNamePtr`	На вводе, указателе на имя второго файла для свопинга.
`ioDestDirID`	На вводе, родительский каталог второго файла ID.
`ioSrcDirID`	На вводе, родительский каталог первого файла ID.

Как правило, Вы используете PBExchangeFilesAsync после создания нового файла во время безопасного сохранения. PBExchangeFilesAsync функционируйте изменяет поля в каталогизационных описаниях, записывающих расположение данных и дат модификации. Это подкачивает и ветви данных и ветви ресурсов.

PBExchangeFilesAsync функционируйте работы или над открытыми или над закрытыми файлами. PBExchangeFilesAsync подкачивает данные в двух файлах путем изменения части информации в каталоге объема. Если любой файл открыт, PBExchangeFilesAsync обновления любые блоки управления файлом связались с файлом. Обмен содержанием двух файлов требует по существу тех же прав доступа как открывающий оба файла для записи.

Следующими полями в каталогизационных описаниях для файлов обмениваются:

ioFlStBlk
ioFlLgLen
ioFlPyLen
ioFlRStBlk
ioFlRLgLen
ioFlRPyLen
ioFlMdDat

В блоках управления файлом, fcbFlNum, fcbDirID, и fcbCName полями обмениваются.

Необходимо использовать PBExchangeFilesAsync сохранить идентификатор файла при обновлении существующего файла, в случае, если файл прослеживается через его идентификатор файла. PBExchangeFilesAsync функция не требует, чтобы ссылки идентификатора файла существовали для файлов, которыми обмениваются.

Специальные замечания

Поскольку другие программы могут иметь пути доступа, открытые для одного или обоих из файлов, которыми обмениваются, Ваше приложение должно иметь монопольное разрешение доступа для чтения-записи (fsRdWrPerm) к обоим файлам перед вызовом PBExchangeFilesAsync. Монопольный доступ для чтения-записи к обоим файлам гарантирует это PBExchangeFilesAsync не влияет на другое приложение, потому что оно препятствует тому, чтобы другие приложения получили доступ для записи к одному или обоим из файлов, которыми обмениваются.

PBExchangeFilesAsync не уважает заблокированный файлом атрибут; даже если один или оба из файлов будут заблокированы, это выполнит обмен. Получение монопольного доступа для чтения-записи к обоим файлам перед вызовом PBExchangeFilesAsync гарантирует, что файлы разблокированы, потому что заблокированные файлы не могут быть открыты с доступом для записи.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.

Получение и установка информации об объеме


    
    FSGetVolumeInfo
    FSGetVolumeInfo

(OS X v10.8)

Информация о возвратах об объеме.

Оператор осуждения

На уровне Foundation использовать getResourceValue:forKey:error: или resourceValuesForKeys:error: вместо этого. На уровне Core Foundation использовать CFURLCopyResourcePropertyForKey или CFURLCopyResourcePropertiesForKeys вместо этого. Для перечисления объемов использовать mountedVolumeURLsIncludingResourceValuesForKeys:options: или CFURLEnumeratorRef API вместо этого.

Объявление

Objective C

OSErr FSGetVolumeInfo ( FSVolumeRefNum volume, ItemCount volumeIndex, FSVolumeRefNum *actualVolume, FSVolumeInfoBitmap whichInfo, FSVolumeInfo *info, HFSUniStr255 *volumeName, FSRef *rootDirectory );

Параметры

`volume`	Если Вы хотите получить информацию об определенном объеме, передайте ссылочный номер того объема сюда. Если Вы хотите индексировать через список смонтированных объемов, передайте константу `kFSInvalidVolumeRefNum` в этом параметре. Посмотрите `FSVolumeRefNum` для описания `FSVolumeRefNum` тип данных.
`volumeIndex`	Индекс желаемого объема, или 0 для использования ссылочного номера объема в `volume` параметр.
`actualVolume`	По возврату, указателю на ссылочный номер объема объема. Это полезно при индексации по всем смонтированным объемам. Если Вы не хотите эту информацию (например, при предоставлении определенного ссылочного номера объема в `volume`) параметр, набор `actualVolume` к `NULL`.
`whichInfo`	Битовый массив, указывающий, который поля информации об объеме добраться и возвратиться в `info` параметр. Если Вы не хотите информации об объеме, возвращенном в `info` параметр, набор `whichInfo` к `kFSVolInfoNone`. Посмотрите Растровые Константы информации об Объеме для описания битов в этом параметре.
`info`	По возврату, указателю на информацию об объеме. Если Вы не хотите этот вывод, установите этот параметр на `NULL`. Посмотрите `FSVolumeInfo` для описания `FSVolumeInfo` тип данных.
`volumeName`	По возврату, указателю на имя Unicode объема. Если Вам не жаль, что имя не возвратилось, передача `NULL`. Посмотрите `HFSUniStr255` для описания `HFSUniStr255` тип данных.
`rootDirectory`	По возврату, указателю на `FSRef` для корневого каталога объема. Если Вам не жаль, что корневой каталог не возвратился, передача `NULL`. Посмотрите `FSRef` для описания `FSRef` тип данных.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Можно указать определенный объем или индекс через список смонтированных объемов. Для получения информации об определенном объеме передайте ссылочный номер объема желаемого объема в volume параметр и набор volumeIndex параметр для обнуления. Индексировать через список смонтированных объемов, передачи kFSInvalidVolumeRefNum в параметре объема и наборе volumeIndex к индексу, запускающемуся в 1 с первым вызовом к FSGetVolumeInfo.

При индексации через список смонтированных объемов можно встретиться с ошибкой с определенным объемом. Завершающийся код ошибки для полного обхода этого списка nsvErr. Для завершенного пересечения всего списка Вам, вероятно, придется ударить индексное количество при обнаружении с другими ошибками (например, ioErr).

Для получения информации о корневом каталоге объема используйте FSGetCatalogInfo функция или один из соответствующего параметра блокирует вызовы, PBGetCatalogInfoSync и PBGetCatalogInfoAsync.

Специальные замечания

После того, как работа, изменяющая сумму свободного пространства на объеме — таком как удаление файла — может быть задержкой перед вызовом к FSGetVolumeInfo возвращает обновленную сумму. Это вызвано тем, что кэши Файлового менеджера и периодически обновляют информацию о файловой системе, для сокращения количества вызовов, выполненных для получения информации от файловой системы. В настоящее время Файловый менеджер обновляет свою информацию каждые 15 секунд. Это прежде всего влияет на объемы NFS. DOS, SMB, UFS и объемы WebDAV были также затронуты этим в предыдущих версиях OS X, но ведут себя правильно в версии 10.3 OS X и позже.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    FSGetVolumeForDiskID
    FSGetVolumeForDiskID

(OS X v10.8)

Связали объем с данным диском.

Оператор осуждения

Для получения объема использовать DADiskCreateFromBSDName, тогда DADiskCopyDescription с kDADiskDescriptionVolumePathKey вместо этого.

Объявление

Objective C

OSStatus FSGetVolumeForDiskID ( CFStringRef diskID, FSVolumeRefNum *vRefNum );

Параметры

`diskID`	Диск ID связался с целевым объемом.
`vRefNum`	Ссылочный номер объема, соответствующего диску ID.

Возвращаемое значение

Возвращает ссылочный номер, идентифицирующий объем.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.4 и позже.

Осуждаемый в OS X v10.8.


    
    FSGetVolumeForDADisk
    FSGetVolumeForDADisk

(OS X v10.8)

Связали объем с данным диском.

Оператор осуждения

Для получения объема URL использовать DADiskCopyDescription с kDADiskDescriptionVolumePathKey вместо этого.

Объявление

Objective C

OSStatus FSGetVolumeForDADisk ( DADiskRef disk, FSVolumeRefNum *vRefNum );

Параметры

`disk`	`DADiskRef` из целевого объема.
`vRefNum`	Ссылочный номер объема, соответствующего диску.

Возвращаемое значение

Возвращает ссылочный номер, идентифицирующий объем.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.4 и позже.

Осуждаемый в OS X v10.8.


    
    FSCopyDADiskForVolume
    FSCopyDADiskForVolume

(OS X v10.8)

Получает копию диска ID для данного объема.

Оператор осуждения

Использовать DADiskCreateFromVolumePath вместо этого.

Объявление

Objective C

OSStatus FSCopyDADiskForVolume ( FSVolumeRefNum vRefNum, DADiskRef *disk );

Параметры

`vRefNum`	Ссылочный номер объема, соответствующего диску.
`disk`	`DADiskRef` из целевого объема.

Возвращаемое значение

Возвращает копию diskID для данного объема.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.4 и позже.

Осуждаемый в OS X v10.8.


    
    PBGetVolumeInfoSync
    PBGetVolumeInfoSync

(OS X v10.8)

Информация о возвратах об объеме.

Оператор осуждения

Объявление

Objective C

OSErr PBGetVolumeInfoSync ( FSVolumeInfoParam *paramBlock );

Параметры


      paramBlock

Указатель на блок параметра информации об объеме. Посмотрите FSVolumeInfoParam для описания FSVolumeInfoParam тип данных.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioVRefNum`	На вводе, объем, информация которого должна быть возвращена. Для получения информации об определенном объеме передайте ссылочный номер того объема и установите `volumeIndex` поле к 0. Для индексации через список смонтированных объемов передайте константу `kFSInvalidVolumeRefNum`Вывод.On, ссылочный номер объема объема. Когда Вы не указали определенный ссылочный номер объема на вводе, это полезно при индексации по всем смонтированным объемам.
`volumeIndex`	На вводе, индексе желаемого объема, или 0 для использования ссылочного номера объема в `ioVRefNum` поле.
`whichInfo`	На вводе, битовый массив, указывающий, который поля информации об объеме возвратиться в `volumeInfo` поле. Если Вы не хотите информации об объеме, возвращенном в `volumeInfo` поле, набор `whichInfo` к `kFSVolInfoNone`. Посмотрите Растровые Константы информации об Объеме для описания битов в этом поле.
`volumeInfo`	На выводе, указателе на информацию об объеме, как описано `FSVolumeInfo` тип данных. Если Вы не хотите этот вывод, установите это поле в `NULL`.
`volumeName`	На выводе, указателе на имя Unicode объема. Если Вам не жаль, что имя не возвратилось, передача `NULL`. Иначе, передайте указатель на `HFSUniStr255` структура.
`ref`	На выводе, указателе на `FSRef` для корневого каталога объема. Если Вам не жаль, что корневой каталог не возвратился, передача `NULL`.

Можно указать определенный объем или индекс через список смонтированных объемов. Для получения информации об определенном объеме передайте ссылочный номер объема желаемого объема в ioVRefNum поле и набор volumeIndex поле для обнуления. Индексировать через список смонтированных объемов, передачи kFSInvalidVolumeRefNum в ioVRefNum поле и набор volumeIndex к индексу, запускающемуся в 1 с первым вызовом к PBGetVolumeInfoSync.

Специальные замечания

После того, как работа, изменяющая сумму свободного пространства на объеме — таком как удаление файла — может быть задержкой перед вызовом к PBGetVolumeInfoSync возвращает обновленную сумму. Это вызвано тем, что кэши Файлового менеджера и периодически обновляют информацию о файловой системе, для сокращения количества вызовов, выполненных для получения информации от файловой системы. В настоящее время Файловый менеджер обновляет свою информацию каждые 15 секунд. Это прежде всего влияет на объемы NFS. DOS, SMB, UFS и объемы WebDAV были также затронуты этим в предыдущих версиях OS X, но ведут себя правильно в версии 10.3 OS X и позже.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    PBGetVolumeInfoAsync
    PBGetVolumeInfoAsync

(OS X v10.8)

Информация о возвратах об объеме.

Оператор осуждения

Объявление

Objective C

void PBGetVolumeInfoAsync ( FSVolumeInfoParam *paramBlock );

Параметры


      paramBlock

Указатель на блок параметра информации об объеме. Посмотрите FSVolumeInfoParam для описания FSVolumeInfoParam тип данных.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции.
`ioVRefNum`	На вводе, объем, информация которого должна быть возвращена. Для получения информации об определенном объеме передайте ссылочный номер того объема и установите `volumeIndex` поле к 0. Для индексации через список смонтированных объемов передайте константу `kFSInvalidVolumeRefNum`Вывод.On, ссылочный номер объема объема. Когда Вы не указали определенный ссылочный номер объема на вводе, это полезно при индексации по всем смонтированным объемам.
`volumeIndex`	На вводе, индексе желаемого объема, или 0 для использования ссылочного номера объема в `ioVRefNum` поле.
`whichInfo`	На вводе, битовый массив, указывающий, который поля информации об объеме возвратиться в `volumeInfo` поле. Если Вы не хотите информации об объеме, возвращенном в `volumeInfo` поле, набор `whichInfo` к `kFSVolInfoNone`. Посмотрите Растровые Константы информации об Объеме для описания битов в этом поле.
`volumeInfo`	На выводе, указателе на информацию об объеме, как описано `FSVolumeInfo` тип данных. Если Вы не хотите этот вывод, установите это поле в `NULL`.
`volumeName`	На выводе, указателе на имя Unicode объема. Если Вам не жаль, что имя не возвратилось, передача `NULL`. Иначе, передайте указатель на `HFSUniStr255` структура.
`ref`	На выводе, указателе на `FSRef` для корневого каталога объема. Если Вам не жаль, что корневой каталог не возвратился, передача `NULL`.

Можно указать определенный объем или индекс через список смонтированных объемов. Для получения информации об определенном объеме передайте ссылочный номер объема желаемого объема в ioVRefNum поле и набор volumeIndex поле для обнуления. Индексировать через список смонтированных объемов, передачи kFSInvalidVolumeRefNum в ioVRefNum поле и набор volumeIndex к индексу, запускающемуся в 1 с первым вызовом к PBGetVolumeInfoAsync.

Специальные замечания

После того, как работа, изменяющая сумму свободного пространства на объеме — таком как удаление файла — может быть задержкой перед вызовом к PBGetVolumeInfoAsync возвращает обновленную сумму. Это вызвано тем, что кэши Файлового менеджера и периодически обновляют информацию о файловой системе, для сокращения количества вызовов, выполненных для получения информации от файловой системы. В настоящее время Файловый менеджер обновляет свою информацию каждые 15 секунд. Это прежде всего влияет на объемы NFS. DOS, SMB, UFS и объемы WebDAV были также затронуты этим в предыдущих версиях OS X, но ведут себя правильно в версии 10.3 OS X и позже.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    FSSetVolumeInfo
    FSSetVolumeInfo

(OS X v10.8)

Информация о наборах об объеме.

Оператор осуждения

Объявление

Objective C

OSErr FSSetVolumeInfo ( FSVolumeRefNum volume, FSVolumeInfoBitmap whichInfo, const FSVolumeInfo *info );

Параметры

`volume`	Ссылочный номер объема объема, информация которого должна быть изменена. Посмотрите `FSVolumeRefNum` для описания `FSVolumeRefNum` тип данных.
`whichInfo`	Битовый массив, указывающий, который информация установить. Только некоторые поля информации об объеме могут быть установлены. Устанавливаемые поля даны константой `kFSVolInfoSettableInfo`; никакие другие биты не могут быть установлены в `whichInfo`. Поля, которые могут быть установлены, являются backupDate, finderInfo, и `flags` поля. Посмотрите Растровые Константы информации об Объеме для описания битов в этом параметре.
`info`	Указатель на новую информацию об объеме. Посмотрите `FSVolumeInfo` для описания `FSVolumeInfo` тип данных.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Для установки информации о корневом каталоге объема используйте FSSetCatalogInfo функция или один из соответствующего параметра блокирует вызовы, PBSetCatalogInfoSync и PBSetCatalogInfoAsync.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    PBSetVolumeInfoSync
    PBSetVolumeInfoSync

(OS X v10.8)

Информация о наборах об объеме.

Оператор осуждения

Объявление

Objective C

OSErr PBSetVolumeInfoSync ( FSVolumeInfoParam *paramBlock );

Параметры


      paramBlock

Указатель на блок параметра информации об объеме. Посмотрите FSVolumeInfoParam для описания FSVolumeInfoParam тип данных.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioVRefNum`	На вводе, ссылочном номере объема объема, информация которого должна быть изменена.
`whichInfo`	На вводе, битовый массив, указывающий, который информация установить. Только некоторые поля информации об объеме могут быть установлены. Устанавливаемые поля даны константой `kFSVolInfoSettableInfo`; никакие другие биты не могут быть установлены в `whichInfo`. Поля, которые могут быть установлены, являются backupDate, finderInfo, и `flags` поля. Посмотрите Растровые Константы информации об Объеме для описания битов в этом параметре.
`volumeInfo`	На вводе, новой информации об объеме. Посмотрите `FSVolumeInfo` для получения дополнительной информации об информационной структуре объема.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    PBSetVolumeInfoAsync
    PBSetVolumeInfoAsync

(OS X v10.8)

Информация о наборах об объеме.

Оператор осуждения

Объявление

Objective C

void PBSetVolumeInfoAsync ( FSVolumeInfoParam *paramBlock );

Параметры


      paramBlock

Указатель на блок параметра информации об объеме. Посмотрите FSVolumeInfoParam для описания FSVolumeInfoParam тип данных.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции.
`ioVRefNum`	На вводе, ссылочном номере объема объема, информация которого должна быть изменена.
`whichInfo`	На вводе, битовый массив, указывающий, который информация установить. Только некоторые поля информации об объеме могут быть установлены. Устанавливаемые поля даны константой `kFSVolInfoSettableInfo`; никакие другие биты не могут быть установлены в `whichInfo`. Поля, которые могут быть установлены, являются backupDate, finderInfo, и `flags` поля. Посмотрите Растровые Константы информации об Объеме для описания битов в этом параметре.
`volumeInfo`	На вводе, новой информации об объеме. Посмотрите `FSVolumeInfo` для получения дополнительной информации об информационной структуре объема.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    FSCopyDiskIDForVolume
    FSCopyDiskIDForVolume

(OS X v10.8)

Возвращает копию диска ID для объема.

Оператор осуждения

Использовать DADiskCreateFromVolumePath вместо этого.

Объявление

Objective C

OSStatus FSCopyDiskIDForVolume ( FSVolumeRefNum vRefNum, CFStringRef *diskID );

Параметры

`vRefNum`	Ссылочный номер объема целевого объема.
`diskID`	Указатель на Базовую строку Основы. По возврату строка содержит диск ID, связанный с целевым объемом. Вызывающая сторона ответственна за выпуск строки.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.2 и позже.

Осуждаемый в OS X v10.8.


    
    FSCopyURLForVolume
    FSCopyURLForVolume

(OS X v10.8)

Возвращает копию URL для объема.

Оператор осуждения

Для получения URL для объема используйте NSURLVolumeURLKey (или kCFURLVolumeURLKey) свойства вместо этого. Чтобы потребовать, чтобы URL повторно смонтировал сетевой том, используйте NSURLVolumeURLForRemountingKey (или kCFURLVolumeURLForRemountingKey) свойства вместо этого.

Объявление

Objective C

OSStatus FSCopyURLForVolume ( FSVolumeRefNum vRefNum, CFURLRef *url );

Параметры

`vRefNum`	Ссылочный номер объема целевого объема.
`url`	Указатель на a `CFURLRef` переменная выделяется вызывающей стороной. По возврату, Базовая Основа URL, указывающий расположение целевого объема. Вызывающая сторона ответственна за выпуск URL.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.3 и позже.

Осуждаемый в OS X v10.8.


    
    GetVRefNum
    GetVRefNum

(OS X v10.4)

Получает ссылочный номер объема от числа ссылки на файл.

Оператор осуждения

Использовать FSGetCatalogInfo вместо этого.

Объявление

Objective C

OSErr GetVRefNum ( FSIORefNum fileRefNum, FSVolumeRefNum *vRefNum );

Параметры

`fileRefNum`	Число ссылки на файл открытого файла.
`vRefNum`	По возврату, указателю на ссылочный номер объема объема, содержащего файл, указанный в `refNum` параметр.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Если Вы также хотите определить каталог ID родительского каталога указанного файла, вызовите PBGetFCBInfoSync или PBGetFCBInfoAsync функции.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    PBHGetVInfoSync
    PBHGetVInfoSync

(OS X v10.4)

Получает подробную информацию об объеме.

Оператор осуждения

Использовать PBGetVolumeInfoSync вместо этого.

Объявление

Objective C

OSErr PBHGetVInfoSync ( HParmBlkPtr paramBlock );

Параметры


      paramBlock

Указатель на HVolumeParam вариант основного блока параметра HFS. Посмотрите HParamBlockRec для описания HParamBlockRec тип данных.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioNamePtr`	На вводе, указателе на буфер. Если Вы указываете отрицательное число в `ioVolIndex` поле, этот буфер должен содержать имя объема, для которого можно возвратить информацию. На выводе, указателе на имя объема. Необходимо передать указатель на a `Str31` оцените, если Вы хотите возвращенное имя. Если Вы передаете `NULL`, никакое имя тома не возвращается.
`ioVRefNum`	На вводе, ссылочном номере объема или числе диска для объема, для которого можно возвратить информацию; или 0 для объема по умолчанию. Если `ioVolIndex` поле отрицательно, Файловый менеджер использует значение в `ioNamePtr` поле, вместе со значением, указанным в `ioVRefNum` поле, для определения объема. Если значение в `ioVolIndex` 0, Файловый менеджер пытается получить доступ к объему с помощью только значение в этом поле. На выводе, ссылочном номере объема.
`ioVolIndex`	На вводе индекс используется для индексации через все смонтированные объемы. Если это значение положительно, Файловый менеджер использует его для нахождения объема, для которого можно возвратить информацию. Например, если значение `ioVolIndex` 2, Файловый менеджер пытается получить доступ к второму смонтированному объему в очереди VCB. Если `ioVolIndex` отрицательно, Файловый менеджер использует значения в `ioNamePtr` и `ioVRefNum` поля для доступа к требуемому объему. Если `ioVolIndex` 0, Файловый менеджер использует только значение в `ioVRefNum` поле.
`ioVCrDate`	На выводе, дате и времени инициализации объема.
`ioVLsMod`	На выводе, дате и времени последнего изменения объема.
`ioVAtrb`	На выводе, атрибутах объема. Посмотрите Константы Атрибута информации об Объеме для описания атрибутов объема, возвращенных этой функцией.
`ioVNmFls`	На выводе, числе файлов в корневом каталоге объема. По причинам производительности Файловый менеджер Углерода не возвращает число файлов в этом поле; вместо этого, это устанавливает `ioVNmFls` к 0. Для определения числа файлов в корневом каталоге объема в Углероде вызвать `PBGetCatInfoSync` для корневого каталога. Число файлов в корневом каталоге возвращается в `ioDrNmFls` поле.
`ioVBitMap`	На выводе, первом блоке битового массива объема.
`ioVAllocPtr`	На выводе, блоке, в котором должен запуститься поиск следующего нового размещения файлов.
`ioVNmAlBlks`	На выводе число выделения блокирует на объеме.
`ioVAlBlkSiz`	На выводе, размере блоков выделения.
`ioVClpSiz`	На выводе, размере глыбы по умолчанию.
`ioAlBlSt`	На выводе, первом блоке в блок-диаграмме объема.
`ioVNxtCNID`	На выводе, следующий неиспользованный узел каталога ID.
`ioVFrBlk`	На выводе, числе неиспользованных блоков выделения.
`ioVSigWord`	На выводе, подписи объема. Для объемов HFS это - ‘BD’ для HFS Плюс объемы, это ‘H +’.
`ioVDrvInfo`	На выводе, числе диска. Можно определить, является ли данный объем онлайновым путем проверки значения этого поля. Для онлайновых объемов, `ioVDrvInfo` поле содержит число диска диска, содержащего указанный объем, и следовательно всегда больше, чем 0. Если значение возвратилось в `ioVDrvInfo` 0, объем или оффлайн или извлечен. OS X не поддерживает числа диска; в OS X Файловый менеджер всегда возвращает значение 1 в этом поле.
`ioVDRefNum`	На выводе, ссылочном номере драйвера. Можно определить, является ли объем оффлайновым или извлекается путем проверки значения этого поля. Если объем является оффлайновым, значение `ioVDRefNum` отрицание числа диска (который очищен, когда объем помещается оффлайн; следовательно `ioVDrvInfo` поле для оффлайнового объема является нулем), и отрицательное число. Если объем извлекается, значение `ioVDRefNum` само число диска, и таким образом положительное число. Для онлайновых объемов, `ioVDRefNum` содержит ссылочный номер драйвера; эти числа всегда - меньше чем 0.
`ioVFSID`	На выводе, файловая система, обрабатывающая этот объем.
`ioVBkUp`	На выводе, дате и времени последнего резервного копирования объема.
`ioVSeqNum`	Используемый внутренне.
`ioVWrCnt`	На выводе, количестве записи объема.
`ioVFilCnt`	На выводе, числе файлов на объеме.
`ioVDirCnt`	На выводе, числе каталогов на объеме.
`ioVFndrInfo`	На выводе, информации о Средстве поиска для объема.

Можно получить информацию обо всех онлайновых объемах путем совершения повторенных звонков к PBHGetVInfoSync, начиная со значения ioVolIndex полевой набор к 1 и постепенное увеличение, которые оценивают до PBHGetVInfoSync возвраты nsvErr.

Если необходимо получить информацию о HFS Плюс объемы, необходимо использовать FSGetVolumeInfo функция или один из соответствующего параметра блокирует вызовы, PBGetVolumeInfoSync и PBGetVolumeInfoAsync. PBHGetVInfoSync функция все еще поддерживается для HFS Плюс объемы, но существует дополнительная информация, возвращенная FSGetVolumeInfo функция (такая как дата и время, что объем был в последний раз проверен на непротиворечивость).

Специальные замечания

После того, как работа, изменяющая сумму свободного пространства на объеме — таком как удаление файла — может быть задержкой перед вызовом к PBHGetVInfoSync возвращает обновленную сумму. Это вызвано тем, что кэши Файлового менеджера и периодически обновляют информацию о файловой системе, для сокращения количества вызовов, выполненных для получения информации от файловой системы. В настоящее время Файловый менеджер обновляет свою информацию каждые 15 секунд. Это прежде всего влияет на объемы NFS. DOS, SMB, UFS и объемы WebDAV были также затронуты этим в предыдущих версиях OS X, но ведут себя правильно в версии 10.3 OS X и позже.

Если значение ioVolIndex отрицательно, использование Файлового менеджера ioNamePtr и ioVRefNum стандартным способом определить объем. Однако, потому что PBHGetVInfoSync возвращает имя тома в буфере, в адресе которого Вы передали ioNamePtr, Ваш входной путь будет изменен. Если Вы не хотите своего входного измененного пути, сделайте копию из него и передайте копию PBHGetVInfoSync.

Имя тома, возвращенное PBHGetVInfoSync не полный путь к объему, потому что он не содержит двоеточие.

Для совместимости с более старыми программами, некоторые значения, возвращенные PBHGetVInfoSync не то, что сохранено в Volume Control Block (VCB) объема. В частности:

ioVNmAlBlks и ioVFrBlk прикрепляются к значениям который, когда умножено на ioVAlBlkSiz, всегда меньше чем 2 гигабайта.
ioVNmAlBlks может не включать блоки выделения, используемые каталогом, и степени переполняют файлов.
4 244$ возвращаются в ioVSigWord и для HFS и для HFS Плюс объемы.

Для неприкрепленных общих и свободных количеств байта, и для реального ioVSigWord, использовать PBXGetVolInfoSync вместо PBHGetVInfoSync.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    PBHGetVInfoAsync
    PBHGetVInfoAsync

(OS X v10.4)

Получает подробную информацию об объеме.

Оператор осуждения

Использовать PBGetVolumeInfoAsync вместо этого.

Объявление

Objective C

OSErr PBHGetVInfoAsync ( HParmBlkPtr paramBlock );

Параметры


      paramBlock

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции.
`ioNamePtr`	На вводе, указателе на буфер. Если Вы указываете отрицательное число в `ioVolIndex` поле, этот буфер должен содержать имя объема, для которого можно возвратить информацию. На выводе, указателе на имя объема. Необходимо передать указатель на a `Str31` оцените, если Вы хотите возвращенное имя. Если Вы передаете `NULL`, никакое имя тома не возвращается.
`ioVRefNum`	На вводе, спецификации объема для объема, для которого можно возвратить информацию. Если `ioVolIndex` поле отрицательно, Файловый менеджер использует значение в `ioNamePtr` поле, вместе со значением, указанным в `ioVRefNum` поле, для определения объема. Если значение в `ioVolIndex` 0, Файловый менеджер пытается получить доступ к объему с помощью только значение в этом поле. На выводе, ссылочном номере объема.
`ioVolIndex`	На вводе индекс используется для индексации через все смонтированные объемы. Если это значение положительно, Файловый менеджер использует его для нахождения объема, для которого можно возвратить информацию. Например, если значение `ioVolIndex` 2, Файловый менеджер пытается получить доступ к второму смонтированному объему в очереди VCB. Если `ioVolIndex` отрицательно, Файловый менеджер использует значения в `ioNamePtr` и `ioVRefNum` поля для доступа к требуемому объему. Если `ioVolIndex` 0, Файловый менеджер использует только значение в `ioVRefNum` поле.
`ioVCrDate`	На выводе, дате и времени инициализации объема.
`ioVLsMod`	На выводе, дате и времени последнего изменения объема.
`ioVAtrb`	На выводе, атрибутах объема. Посмотрите Константы Атрибута информации об Объеме для описания атрибутов объема, возвращенных этой функцией.
`ioVNmFls`	На выводе, числе файлов в корневом каталоге объема. По причинам производительности Файловый менеджер Углерода не возвращает число файлов в этом поле; вместо этого, это устанавливает `ioVNmFls` к 0. Для определения числа файлов в корневом каталоге объема в Углероде вызвать `PBGetCatInfoAsync` для корневого каталога. Число файлов в корневом каталоге возвращается в `ioDrNmFls` поле.
`ioVBitMap`	На выводе, первом блоке битового массива объема.
`ioVAllocPtr`	На выводе, блоке, в котором должен запуститься поиск следующего нового размещения файлов.
`ioVNmAlBlks`	На выводе число выделения блокирует на объеме.
`ioVAlBlkSiz`	На выводе, размере блоков выделения.
`ioVClpSiz`	На выводе, размере глыбы по умолчанию.
`ioAlBlSt`	На выводе, первом блоке в блок-диаграмме объема.
`ioVNxtCNID`	На выводе, следующий неиспользованный узел каталога ID.
`ioVFrBlk`	На выводе, числе неиспользованных блоков выделения.
`ioVSigWord`	На выводе, подписи объема. Для объемов HFS это - ‘BD’ для HFS Плюс объемы, это ‘H +’.
`ioVDrvInfo`	На выводе, числе диска. Можно определить, является ли данный объем онлайновым путем проверки значения этого поля. Для онлайновых объемов, `ioVDrvInfo` поле содержит число диска диска, содержащего указанный объем, и следовательно всегда больше, чем 0. Если значение возвратилось в `ioVDrvInfo` 0, объем или оффлайн или извлечен. OS X не поддерживает числа диска; в OS X Файловый менеджер всегда возвращает значение 1 в этом поле.
`ioVDRefNum`	На выводе, ссылочном номере драйвера. Можно определить, является ли объем оффлайновым или извлекается путем проверки значения этого поля. Если объем является оффлайновым, значение `ioVDRefNum` отрицание числа диска (который очищен, когда объем помещается оффлайн; следовательно `ioVDrvInfo` поле для оффлайнового объема является нулем), и отрицательное число. Если объем извлекается, значение `ioVDRefNum` само число диска, и таким образом положительное число. Для онлайновых объемов, `ioVDRefNum` содержит ссылочный номер драйвера; эти числа всегда - меньше чем 0.
`ioVFSID`	На выводе, файловая система, обрабатывающая этот объем.
`ioVBkUp`	На выводе, дате и времени последнего резервного копирования объема.
`ioVSeqNum`	Используемый внутренне.
`ioVWrCnt`	На выводе, количестве записи объема.
`ioVFilCnt`	На выводе, числе файлов на объеме.
`ioVDirCnt`	На выводе, числе каталогов на объеме.
`ioVFndrInfo`	На выводе, информации о Средстве поиска для объема.

Можно получить информацию обо всех онлайновых объемах путем совершения повторенных звонков к PBHGetVInfoAsync, начиная со значения ioVolIndex полевой набор к 1 и постепенное увеличение, которые оценивают до PBHGetVInfoAsync возвраты nsvErr.

Если необходимо получить информацию о HFS Плюс объемы, необходимо использовать FSGetVolumeInfo функция или один из соответствующего параметра блокирует вызовы, PBGetVolumeInfoSync и PBGetVolumeInfoAsync. PBHGetVInfoAsync функция все еще поддерживается для HFS Плюс объемы, но существует дополнительная информация, возвращенная FSGetVolumeInfo функция (такая как дата и время, что объем был в последний раз проверен на непротиворечивость).

Специальные замечания

После того, как работа, изменяющая сумму свободного пространства на объеме — таком как удаление файла — может быть задержкой перед вызовом к PBHGetVInfoAsync возвращает обновленную сумму. Это вызвано тем, что кэши Файлового менеджера и периодически обновляют информацию о файловой системе, для сокращения количества вызовов, выполненных для получения информации от файловой системы. В настоящее время Файловый менеджер обновляет свою информацию каждые 15 секунд. Это прежде всего влияет на объемы NFS. DOS, SMB, UFS и объемы WebDAV были также затронуты этим в предыдущих версиях OS X, но ведут себя правильно в версии 10.3 OS X и позже.

Если значение ioVolIndex отрицательно, использование Файлового менеджера ioNamePtr и ioVRefNum стандартным способом определить объем. Однако, потому что PBHGetVInfoAsync возвращает имя тома в буфере, в адресе которого Вы передали ioNamePtr, Ваш входной путь будет изменен. Если Вы не хотите своего входного измененного пути, сделайте копию из него и передайте копию PBHGetVInfoAsync.

Имя тома, возвращенное PBHGetVInfoAsync не полный путь к объему, потому что он не содержит двоеточие.

Для совместимости с более старыми программами, некоторые значения, возвращенные PBHGetVInfoAsync не то, что сохранено в Volume Control Block (VCB) объема. В частности:

ioVNmAlBlks и ioVFrBlk прикрепляются к значениям который, когда умножено на ioVAlBlkSiz, всегда меньше чем 2 гигабайта.
ioVNmAlBlks может не включать блоки выделения, используемые каталогом, и степени переполняют файлов.
4 244$ возвращаются в ioVSigWord и для HFS и для HFS Плюс объемы.

Для неприкрепленных общих и свободных количеств байта, и для реального ioVSigWord, использовать PBXGetVolInfoAsync вместо PBHGetVInfoAsync.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    PBSetVInfoSync
    PBSetVInfoSync

(OS X v10.4)

Информация об изменениях об объеме.

Оператор осуждения

Использовать PBSetVolumeInfoSync вместо этого.

Объявление

Objective C

OSErr PBSetVInfoSync ( HParmBlkPtr paramBlock );

Параметры


      paramBlock

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioNamePtr`	На вводе, указателе на имя объема. Можно указать новое имя для объема здесь. Вы не можете указать объем по имени, необходимо использовать или ссылочный номер объема или число диска.
`ioVRefNum`	На вводе, ссылочном номере объема или числе диска для объема, информация которого должна быть изменена; или 0 для объема по умолчанию.
`ioVCrDate`	На вводе, дате и времени инициализации объема.
`ioVLsMod`	На вводе, дате и времени последнего изменения объема.
`ioVAtrb`	На вводе, атрибутах объема. Только бит 15 из `ioVAtrb` поле может быть изменено; установка его блокирует объем. Посмотрите Константы Атрибута информации об Объеме для описания атрибутов объема.
`ioVBkUp`	На вводе, дате и времени последнего резервного копирования объема.
`ioVSeqNum`	Используемый внутренне.
`ioVFndrInfo`	На вводе, информации о Средстве поиска для объема.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    PBSetVInfoAsync
    PBSetVInfoAsync

(OS X v10.4)

Информация об изменениях об объеме.

Оператор осуждения

Использовать PBSetVolumeInfoAsync вместо этого.

Объявление

Objective C

OSErr PBSetVInfoAsync ( HParmBlkPtr paramBlock );

Параметры


      paramBlock

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции.
`ioNamePtr`	На вводе, указателе на имя объема. Можно указать новое имя для объема здесь. Вы не можете указать объем по имени, необходимо использовать или ссылочный номер объема или число диска.
`ioVRefNum`	На вводе, ссылочном номере объема или числе диска для объема, информация которого должна быть изменена; или 0 для объема по умолчанию.
`ioVCrDate`	На вводе, дате и времени инициализации объема.
`ioVLsMod`	На вводе, дате и времени последнего изменения объема.
`ioVAtrb`	На вводе, атрибутах объема. Только бит 15 из `ioVAtrb` поле может быть изменено; установка его блокирует объем. Посмотрите Константы Атрибута информации об Объеме для описания атрибутов объема.
`ioVBkUp`	На вводе, дате и времени последнего резервного копирования объема.
`ioVSeqNum`	Используемый внутренне.
`ioVFndrInfo`	На вводе, информации о Средстве поиска для объема.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    PBXGetVolInfoSync
    PBXGetVolInfoSync

(OS X v10.4)

Информация о возвратах об объеме, включая информацию о размере для объемов до 2 терабайт.

Оператор осуждения

Использовать FSGetVolumeInfo вместо этого.

Объявление

Objective C

OSErr PBXGetVolInfoSync ( XVolumeParamPtr paramBlock );

Параметры


      paramBlock

Указатель на расширенный блок параметра объема. Посмотрите XVolumeParam для описания XVolumeParam тип данных.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioNamePtr`	На вводе, указателе на буфер. Необходимо передать указатель на a `Str31` оцените, если Вы хотите возвращенное имя тома; иначе, передача `NULL`. Если Вы указываете отрицательное число в `ioVolIndex` поле, этот буфер должен содержать имя объема, для которого можно возвратить информацию. На выводе, указателе на имя объема.
`ioVRefNum`	На вводе, ссылочном номере объема, числе диска, или 0 для объема по умолчанию. Если значение в `ioVolIndex` поле отрицательно, Файловый менеджер использует имя в `ioNamePtr` поле, вместе со значением в `ioVRefNum` поле, для определения объема. Если значение в `ioVolIndex` 0, Файловый менеджер пытается получить доступ к объему с помощью только значение в этом поле. На выводе, ссылочном номере объема.
`ioXVersion`	На вводе, версии расширенного блока параметра объема. В настоящее время это значение 0.
`ioVolIndex`	На вводе индекс используется для индексации через все смонтированные объемы. Если это значение положительно, Файловый менеджер использует его для нахождения объема, для которого можно возвратить информацию. Например, если значение `ioVolIndex` 2, Файловый менеджер пытается получить доступ к второму смонтированному объему в очереди VCB. Если `ioVolIndex` отрицательно, Файловый менеджер использует значения в `ioNamePtr` и `ioVRefNum` поля для доступа к требуемому объему. Если `ioVolIndex` 0, Файловый менеджер использует только значение в `ioVRefNum` поле.
`ioVCrDate`	На выводе, дате и времени создания объема (инициализация).
`ioVLsMod`	На выводе, дата и время, что был в последний раз изменен объем.
`ioVAtrb`	На выводе, атрибутах объема. Посмотрите Константы Атрибута информации об Объеме для описания этих атрибутов.
`ioVNmFls`	На выводе, числе файлов в корневом каталоге объема. По причинам производительности Файловый менеджер Углерода не возвращает число файлов в этом поле; вместо этого, это устанавливает `ioVNmFls` к 0. Для определения числа файлов в корневом каталоге объема в Углероде вызвать `PBGetCatInfoSync` для корневого каталога. Число файлов в корневом каталоге возвращается в `ioDrNmFls` поле.
`ioVBitMap`	На выводе, первом блоке битового массива объема.
`ioVAllocPtr`	На выводе, блок, где должен запуститься следующий новый поиск размещения файлов.
`ioVNmAlBlks`	На выводе число выделения блокирует на объеме.
`ioVAlBlkSiz`	На выводе, размере блока выделения для объема.
`ioVClpSiz`	На выводе, размере глыбы объема по умолчанию.
`ioAlBlSt`	На выводе, первом блоке в блок-диаграмме объема.
`ioVNxtCNID`	На выводе, следующий неиспользованный узел каталога ID.
`ioVFrBlk`	На выводе число свободного (неиспользованного) выделения блокирует на объеме.
`ioVSigWord`	На выводе, подписи объема. Для объемов HFS это - ‘BD’ для HFS Плюс объемы, это ‘H +’.
`ioVDrvInfo`	На выводе, числе диска. Можно определить, является ли данный объем онлайновым путем проверки значения этого поля. Для онлайновых объемов, `ioVDrvInfo` поле содержит число диска диска, содержащего указанный объем, и следовательно всегда больше, чем 0. Если значение возвратилось в `ioVDrvInfo` 0, объем или оффлайн или извлечен.
`ioVDRefNum`	На выводе, ссылочном номере драйвера. Можно определить, является ли объем оффлайновым или извлекается путем проверки значения этого поля. Если объем является оффлайновым, значение `ioVDRefNum` отрицание числа диска (который очищен, когда объем помещается оффлайн; следовательно `ioVDrvInfo` поле для оффлайнового объема является нулем), и отрицательное число. Если объем извлекается, значение `ioVDRefNum` само число диска, и таким образом положительное число. Для онлайновых объемов, `ioVDRefNum` содержит ссылочный номер драйвера; эти числа всегда - меньше чем 0.
`ioVFSID`	На выводе, файловая система ID для файловой системы, обрабатывающей этот объем.
`ioVBkUp`	На выводе, дата и время, что был в последний раз скопирован объем.
`ioVSeqNum`	Используемый внутренне.
`ioVWrCnt`	На выводе, количестве записи объема.
`ioVFilCnt`	На выводе, числе файлов на объеме.
`ioVDirCnt`	На выводе, числе каталогов на объеме.
`ioVFndrInfo`	На выводе, информации о Средстве поиска для объема.
`ioVTotalBytes`	На выводе, общем количестве байтов на объеме.
`ioVFreeBytes`	На выводе, числе свободных байтов на объеме.

PBXGetVolInfoSync функция подобна PBHGetVInfoSync функционируйте за исключением того, что это возвращает дополнительную информацию о пространстве тома в 64-разрядных целых числах и не изменяет информацию, скопированную с блока регулятора громкости (VCB) объема. Системы та поддержка PBXGetVolInfoSync будет иметь gestaltFSSupports2TBVols набор битов в ответе, возвращенном gestaltFSAttr Gestalt селектор. Посмотрите Внутренний OS X: менеджер по Гештальту Референс по описанию gestaltFSAttr селектор и битов, которые могут быть возвращены в ответе.

Специальные замечания

После того, как работа, изменяющая сумму свободного пространства на объеме — таком как удаление файла — может быть задержкой перед вызовом к PBXGetVolInfoSync возвращает обновленную сумму. Это вызвано тем, что кэши Файлового менеджера и периодически обновляют информацию о файловой системе, для сокращения количества вызовов, выполненных для получения информации от файловой системы. В настоящее время Файловый менеджер обновляет свою информацию каждые 15 секунд. Это прежде всего влияет на объемы NFS. DOS, SMB, UFS и объемы WebDAV были также затронуты этим в предыдущих версиях OS X, но ведут себя правильно в версии 10.3 OS X и позже.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    PBXGetVolInfoAsync
    PBXGetVolInfoAsync

(OS X v10.4)

Информация о возвратах об объеме, включая информацию о размере для объемов до 2 терабайт.

Оператор осуждения

Использовать FSGetVolumeInfo вместо этого.

Объявление

Objective C

OSErr PBXGetVolInfoAsync ( XVolumeParamPtr paramBlock );

Параметры


      paramBlock

Указатель на расширенный блок параметра объема. Посмотрите XVolumeParam для описания XVolumeParam тип данных.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, функциональном результате.
`ioNamePtr`	На вводе, указателе на буфер. Необходимо передать указатель на a `Str31` оцените, если Вы хотите возвращенное имя тома; иначе, передача `NULL`. Если Вы указываете отрицательное число в `ioVolIndex` поле, этот буфер должен содержать имя объема, для которого можно возвратить информацию. На выводе, указателе на имя объема.
`ioVRefNum`	На вводе, ссылочном номере объема, числе диска, или 0 для объема по умолчанию. Если значение в `ioVolIndex` поле отрицательно, Файловый менеджер использует имя в `ioNamePtr` поле, вместе со значением в `ioVRefNum` поле, для определения объема. Если значение в `ioVolIndex` 0, Файловый менеджер пытается получить доступ к объему с помощью только значение в этом поле. На выводе, ссылочном номере объема.
`ioXVersion`	На вводе, версии расширенного блока параметра объема. В настоящее время это значение 0.
`ioVolIndex`	На вводе индекс используется для индексации через все смонтированные объемы. Если это значение положительно, Файловый менеджер использует его для нахождения объема, для которого можно возвратить информацию. Например, если значение `ioVolIndex` 2, Файловый менеджер пытается получить доступ к второму смонтированному объему в очереди VCB. Если `ioVolIndex` отрицательно, Файловый менеджер использует значения в `ioNamePtr` и `ioVRefNum` поля для доступа к требуемому объему. Если `ioVolIndex` 0, Файловый менеджер использует только значение в `ioVRefNum` поле.
`ioVCrDate`	На выводе, дате и времени создания объема (инициализация).
`ioVLsMod`	На выводе, дата и время, что был в последний раз изменен объем.
`ioVAtrb`	На выводе, атрибутах объема. Посмотрите Константы Атрибута информации об Объеме для описания этих атрибутов.
`ioVNmFls`	На выводе, числе файлов в корневом каталоге объема. По причинам производительности Файловый менеджер Углерода не возвращает число файлов в этом поле; вместо этого, это устанавливает `ioVNmFls` к 0. Для определения числа файлов в корневом каталоге объема в Углероде вызвать `PBGetCatInfoAsync` для корневого каталога. Число файлов в корневом каталоге возвращается в `ioDrNmFls` поле.
`ioVBitMap`	На выводе, первом блоке битового массива объема.
`ioVAllocPtr`	На выводе, блок, где должен запуститься следующий новый поиск размещения файлов.
`ioVNmAlBlks`	На выводе число выделения блокирует на объеме.
`ioVAlBlkSiz`	На выводе, размере блока выделения для объема.
`ioVClpSiz`	На выводе, размере глыбы объема по умолчанию.
`ioAlBlSt`	На выводе, первом блоке в блок-диаграмме объема.
`ioVNxtCNID`	На выводе, следующий неиспользованный узел каталога ID.
`ioVFrBlk`	На выводе число свободного (неиспользованного) выделения блокирует на объеме.
`ioVSigWord`	На выводе, подписи объема. Для объемов HFS это - ‘BD’ для HFS Плюс объемы, это ‘H +’.
`ioVDrvInfo`	На выводе, числе диска. Можно определить, является ли данный объем онлайновым путем проверки значения этого поля. Для онлайновых объемов, `ioVDrvInfo` поле содержит число диска диска, содержащего указанный объем, и следовательно всегда больше, чем 0. Если значение возвратилось в `ioVDrvInfo` 0, объем или оффлайн или извлечен.
`ioVDRefNum`	На выводе, ссылочном номере драйвера. Можно определить, является ли объем оффлайновым или извлекается путем проверки значения этого поля. Если объем является оффлайновым, значение `ioVDRefNum` отрицание числа диска (который очищен, когда объем помещается оффлайн; следовательно `ioVDrvInfo` поле для оффлайнового объема является нулем), и отрицательное число. Если объем извлекается, значение `ioVDRefNum` само число диска, и таким образом положительное число. Для онлайновых объемов, `ioVDRefNum` содержит ссылочный номер драйвера; эти числа всегда - меньше чем 0.
`ioVFSID`	На выводе, файловая система ID для файловой системы, обрабатывающей этот объем.
`ioVBkUp`	На выводе, дата и время, что был в последний раз скопирован объем.
`ioVSeqNum`	Используемый внутренне.
`ioVWrCnt`	На выводе, количестве записи объема.
`ioVFilCnt`	На выводе, числе файлов на объеме.
`ioVDirCnt`	На выводе, числе каталогов на объеме.
`ioVFndrInfo`	На выводе, информации о Средстве поиска для объема.
`ioVTotalBytes`	На выводе, общем количестве байтов на объеме.
`ioVFreeBytes`	На выводе, числе свободных байтов на объеме.

PBXGetVolInfoAsync функция подобна PBHGetVInfoAsync функционируйте за исключением того, что это возвращает дополнительную информацию о пространстве тома в 64-разрядных целых числах и не изменяет информацию, скопированную с блока регулятора громкости (VCB) объема. Системы та поддержка PBXGetVolInfoAsync будет иметь gestaltFSSupports2TBVols набор битов в ответе, возвращенном gestaltFSAttr Gestalt селектор. Посмотрите Внутренний OS X: менеджер по Гештальту Референс по описанию gestaltFSAttr селектор и битов, которые могут быть возвращены в ответе.

Специальные замечания

После того, как работа, изменяющая сумму свободного пространства на объеме — таком как удаление файла — может быть задержкой перед вызовом к PBXGetVolInfoAsync возвращает обновленную сумму. Это вызвано тем, что кэши Файлового менеджера и периодически обновляют информацию о файловой системе, для сокращения количества вызовов, выполненных для получения информации от файловой системы. В настоящее время Файловый менеджер обновляет свою информацию каждые 15 секунд. Это прежде всего влияет на объемы NFS. DOS, SMB, UFS и объемы WebDAV были также затронуты этим в предыдущих версиях OS X, но ведут себя правильно в версии 10.3 OS X и позже.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.

Получение атрибутов объема

FSGetVolumeParms FSGetVolumeParms (OS X v10.8)

Получает информацию о характеристиках объема.

Оператор осуждения

На уровне Foundation использовать getResourceValue:forKey:error: или resourceValuesForKeys:error: вместо этого. На уровне Core Foundation использовать CFURLCopyResourcePropertyForKey или CFURLCopyResourcePropertiesForKeys вместо этого.

Объявление

Objective C

OSStatus FSGetVolumeParms ( FSVolumeRefNum volume, GetVolParmsInfoBuffer *buffer, ByteCount bufferSize );

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.8.


    
    PBHGetVolParmsSync
    PBHGetVolParmsSync

(OS X v10.5)

Информация о возвратах о характеристиках объема.

Оператор осуждения

Использовать FSGetVolumeParms вместо этого.

Объявление

Objective C

OSErr PBHGetVolParmsSync ( HParmBlkPtr paramBlock );

Параметры


      paramBlock

Указатель на HIOParam вариант основного блока параметра HFS. Посмотрите HParamBlockRec для описания HParamBlockRec тип данных.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioNamePtr`	На вводе, указателе на имя объема. Можно использовать a или имя или спецификация объема для указания объема. При использовании спецификации объема для указания объема, необходимо установить `ioNamePtr` поле к `NULL`.
`ioVRefNum`	На вводе, спецификации объема. Можно использовать a или имя или спецификация объема для указания объема. Спецификация объема может быть ссылочным номером объема, числом диска, или 0 для объема по умолчанию.
`ioBuffer`	На вводе, указателе на a `GetVolParmsInfoBuffer` запись; необходимо выделить эту память для содержания возвращенных атрибутов. По возврату, `PBHGetVolParmsSync` функционируйте помещает информацию об атрибутах в буфер. Объемы, реализующие HFS Плюс APIs, должны использовать версию 3 (или более новый) `GetVolParmsInfoBuffer` структура. Если версия `GetVolParmsInfoBuffer` 2 или меньше, или `bSupportsHFSPlusAPIs` бит ясен, тогда объем не реализует HFS Плюс APIs, и они эмулируются для того объема Файловым менеджером.
`ioReqCount`	На вводе размер, в байтах, буферной области указал в `ioBuffer` поле.
`ioActCount`	На выводе фактически возвратился размер данных.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.5.

Не доступный 64-разрядным приложениям.


    
    PBHGetVolParmsAsync
    PBHGetVolParmsAsync

(OS X v10.5)

Информация о возвратах о характеристиках объема.

Оператор осуждения

Использовать FSGetVolumeParms вместо этого.

Объявление

Objective C

OSErr PBHGetVolParmsAsync ( HParmBlkPtr paramBlock );

Параметры


      paramBlock

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции.
`ioNamePtr`	На вводе, указателе на имя объема. Можно использовать a или имя или спецификация объема для указания объема. При использовании спецификации объема для указания объема, необходимо установить `ioNamePtr` поле к `NULL`.
`ioVRefNum`	На вводе, спецификации объема. Можно использовать a или имя или спецификация объема для указания объема. Спецификация объема может быть ссылочным номером объема, числом диска, или 0 для объема по умолчанию.
`ioBuffer`	На вводе, указателе на a `GetVolParmsInfoBuffer` запись; необходимо выделить эту память для содержания возвращенных атрибутов. По возврату, `PBHGetVolParmsAsync` функционируйте помещает информацию об атрибутах в буфер. Объемы, реализующие HFS Плюс APIs, должны использовать версию 3 (или более новый) `GetVolParmsInfoBuffer` структура. Если версия `GetVolParmsInfoBuffer` 2 или меньше, или `bSupportsHFSPlusAPIs` бит ясен, тогда объем не реализует HFS Плюс APIs, и они эмулируются для того объема Файловым менеджером.
`ioReqCount`	На вводе размер, в байтах, буферной области указал в `ioBuffer` поле.
`ioActCount`	На выводе фактически возвратился размер данных.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.5.

Не доступный 64-разрядным приложениям.

Итерация по именованным ветвлениям


    
    FSIterateForks
    FSIterateForks

(OS X v10.8)

Определяет имя и размер каждого именованного ветвления, принадлежащего файлу или каталогу.

Оператор осуждения

На уровне POSIX/BSD использовать getxattr, listxattr, removexattr, или setxattr получить доступ к ветви ресурсов.

Объявление

Objective C

OSErr FSIterateForks ( const FSRef *ref, CatPositionRec *forkIterator, HFSUniStr255 *forkName, SInt64 *forkSize, UInt64 *forkPhysicalSize );

Параметры

`ref`	Указатель на `FSRef` указание файла или каталога для итерации. Посмотрите `FSRef` для описания `FSRef` тип данных.
`forkIterator`	Указатель на структуру, поддерживающую состояние между вызовами к `FSIterateForks`. Перед первым вызовом, набор `initialize` поле структуры к 0. Итератор ветвления будет обновлен после того, как вызов завершается; обновленный итератор должен быть передан в следующий вызов. Посмотрите `CatPositionRec` для описания `CatPositionRec` тип данных.
`forkName`	По возврату, указателю на имя Unicode ветвления. Этот параметр является дополнительным; если Вам не жаль, что имя не возвратилось, передача a `NULL` указатель. Посмотрите `HFSUniStr255` для описания `HFSUniStr255` тип данных.
`forkSize`	По возврату, указателю на логический размер ветвления, в байтах. Этот параметр является дополнительным; если Вы не хотите получать логический размер ветвления, передайте a `NULL` указатель.
`forkPhysicalSize`	По возврату, указателю на физический размер ветвления (т.е. на сумму площади, выделенной на диске), в байтах. Этот параметр является дополнительным; если Вы не хотите получать физический размер ветвления, передайте a `NULL` указатель.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Так как информация возвращается об одном ветвлении за один раз, несколько вызовов могут потребоваться, чтобы выполнять итерации посредством всех ветвлений. Нет никакой гарантии о порядке, в котором возвращаются ветвления; порядок может варьироваться между итерациями.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    PBIterateForksSync
    PBIterateForksSync

(OS X v10.8)

Определяет имя и размер каждого именованного ветвления, принадлежащего файлу или каталогу.

Оператор осуждения

На уровне POSIX/BSD использовать getxattr, listxattr, removexattr, или setxattr получить доступ к ветви ресурсов.

Объявление

Objective C

OSErr PBIterateForksSync ( FSForkIOParam *paramBlock );

Параметры


      paramBlock

Указатель на ветвление блок параметра I/O. Посмотрите FSForkIOParam для получения дополнительной информации о FSForkIOParam тип данных.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ref`	На вводе, указателе на `FSRef` указание файла или каталога для итерации.
`forkIterator`	Указатель на структуру, поддерживающую состояние между вызовами к `PBIterateForksSync`. Перед первым вызовом, набор `initialize` поле этой структуры к 0. Итератор ветвления будет обновлен после того, как вызов завершается; обновленный итератор должен быть передан в следующий вызов. Посмотрите `CatPositionRec` для описания структуры, на которую указывают в этом поле.
`outForkName`	На выводе, указателе на имя Unicode ветвления.
`positionOffset`	На выводе, логическом размере ветвления, в байтах.
`allocationAmount`	На выводе, физический размер ветвления (т.е. сумма площади, выделенной на диске), в байтах.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    PBIterateForksAsync
    PBIterateForksAsync

(OS X v10.8)

Определяет имя и размер каждого именованного ветвления, принадлежащего файлу или каталогу.

Оператор осуждения

На уровне POSIX/BSD использовать getxattr, listxattr, removexattr, или setxattr получить доступ к ветви ресурсов.

Объявление

Objective C

void PBIterateForksAsync ( FSForkIOParam *paramBlock );

Параметры


      paramBlock

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции.
`ref`	На вводе, указателе на `FSRef` указание файла или каталога для итерации.
`forkIterator`	Указатель на структуру, поддерживающую состояние между вызовами к `PBIterateForksAsync`. Перед первым вызовом, набор `initialize` поле этой структуры к 0. Итератор ветвления будет обновлен после того, как вызов завершается; обновленный итератор должен быть передан в следующий вызов. Посмотрите `CatPositionRec` для описания структуры, на которую указывают в этом поле.
`outForkName`	На выводе, указателе на имя Unicode ветвления.
`positionOffset`	На выводе, логическом размере ветвления, в байтах.
`allocationAmount`	На выводе, физический размер ветвления (т.е. сумма площади, выделенной на диске), в байтах.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.

Блокировка и разблокирование диапазонов файла

FSLockRange FSLockRange (OS X v10.8)

Блокирует диапазон байтов указанного ветвления.

Объявление

Objective C

OSStatus FSLockRange ( FSIORefNum forkRefNum, UInt16 positionMode, SInt64 positionOffset, UInt64 requestCount, UInt64 *rangeStart );

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.4 и позже.
Осуждаемый в OS X v10.8.
PBXLockRangeSync PBXLockRangeSync (OS X v10.8)

Блокирует диапазон байтов указанного ветвления.

Объявление

Objective C

OSStatus PBXLockRangeSync ( FSRangeLockParamPtr paramBlock );

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.4 и позже.
Осуждаемый в OS X v10.8.
PBXLockRangeAsync PBXLockRangeAsync (OS X v10.8)

Блокирует диапазон байтов указанного ветвления.

Объявление

Objective C

OSStatus PBXLockRangeAsync ( FSRangeLockParamPtr paramBlock );

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.4 и позже.
Осуждаемый в OS X v10.8.
FSUnlockRange FSUnlockRange (OS X v10.8)

Разблокировал диапазон байтов указанного ветвления.

Объявление

Objective C

OSStatus FSUnlockRange ( FSIORefNum forkRefNum, UInt16 positionMode, SInt64 positionOffset, UInt64 requestCount, UInt64 *rangeStart );

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.4 и позже.
Осуждаемый в OS X v10.8.
PBXUnlockRangeSync PBXUnlockRangeSync (OS X v10.8)

Разблокировал диапазон байтов указанного ветвления.

Объявление

Objective C

OSStatus PBXUnlockRangeSync ( FSRangeLockParamPtr paramBlock );

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.4 и позже.
Осуждаемый в OS X v10.8.
PBXUnlockRangeAsync PBXUnlockRangeAsync (OS X v10.8)

Разблокировал диапазон байтов указанного ветвления.

Объявление

Objective C

OSStatus PBXUnlockRangeAsync ( FSRangeLockParamPtr paramBlock );

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.4 и позже.
Осуждаемый в OS X v10.8.


    
    PBLockRangeSync
    PBLockRangeSync

(OS X v10.4)

Блокирует часть файла.

Оператор осуждения

Использовать PBXLockRangeSync или FSLockRange вместо этого.

Объявление

Objective C

OSErr PBLockRangeSync ( ParmBlkPtr paramBlock );

Параметры


      paramBlock

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера. Если Вы вызываете PBLockRangeSync в файловой системе, не реализующей его — например, SMB —PBLockRangeSync возвраты noErr и ничего не делает.

Обсуждение

Соответствующие поля блока параметра:

`ioRefNum`	На вводе, числе ссылки на файл файла, владеющего диапазоном для блокировки.
`ioReqCount`	На вводе, числе байтов в диапазоне. Набор `ioReqCount` к –1 для блокировки максимального количества байтов от позиции, указанной в `ioPosOffset` поле.
`ioPosMode`	На вводе, постоянном указании основного расположения для запуска заблокированного диапазона. Посмотрите Константы Режима Позиции для получения дополнительной информации о константах, которые можно использовать для указания основного расположения. Вы не должны использовать `fsFromLEOF` постоянный при блокировке диапазона файла. `PBLockRangeSync` не возвращает запуск заблокированного диапазона; таким образом нет никакого способа определить, какой диапазон был фактически заблокирован, когда Вы указываете `fsFromLEOF`.
`ioPosOffset`	На вводе, смещении от основного расположения, указанного в `ioPosMode` поле для запуска заблокированного диапазона.

PBLockRangeSync функционируйте блокирует часть файла, открытого с совместно используемым разрешением чтения-записи. Начало диапазона, который будет заблокирован, определяется ioPosMode и ioPosOffset поля. Конец диапазона, который будет заблокирован, определяется к началу диапазона и ioReqCount поле. Например, для блокировки первых 50 байтов в файле установить ioReqCount к 50, ioPosMode к fsFromStart, и ioPosOffset к 0.

PBLockRangeSync функционируйте использует те же параметры в качестве обоих PBReadSync и PBWriteSync; путем вызова его сразу прежде PBReadSync, можно использовать информацию в блоке параметра для PBReadSync вызвать.

Когда Вы закончены с данными (обычно после вызова к PBWriteSync), можно вызвать PBUnlockRangeSync освободить ту часть файла для последующего чтения и вызовов записи. Закрытие файла также выпускает все заблокированные диапазоны в том файле.

Специальные замечания

PBLockRangeSync если файл указал в, функция ничего не делает ioRefNum поле открыто с совместно используемым разрешением чтения-записи, но не расположено на объеме удаленного сервера или не расположено под точкой доли на локальном томе с обеспечением совместного доступа. Чтобы проверить, включен ли совместный доступ к файлам в настоящее время, проверьте что bHasPersonalAccessPrivileges бит в vMAttrib поле GetVolParmsInfoBuffer возвращенный PBHGetVolParmsSync функция установлена.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    PBLockRangeAsync
    PBLockRangeAsync

(OS X v10.4)

Блокирует часть файла.

Оператор осуждения

Использовать PBXLockRangeAsync вместо этого.

Объявление

Objective C

OSErr PBLockRangeAsync ( ParmBlkPtr paramBlock );

Параметры


      paramBlock

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции. Если Вы вызываете `PBLockRangeAsync` в файловой системе, не реализующей его — например, SMB —`PBLockRangeAsync` возвраты `noErr` и ничего не делает.
`ioRefNum`	На вводе, числе ссылки на файл файла, владеющего диапазоном для блокировки.
`ioReqCount`	На вводе, числе байтов в диапазоне. Набор `ioReqCount` к –1 для блокировки максимального количества байтов от позиции, указанной в `ioPosOffset` поле.
`ioPosMode`	На вводе, постоянном указании основного расположения для запуска заблокированного диапазона. Посмотрите Константы Режима Позиции для получения дополнительной информации о константах, которые можно использовать для указания основного расположения. Вы не должны использовать `fsFromLEOF` постоянный при блокировке диапазона файла. `PBLockRangeAsync` не возвращает запуск заблокированного диапазона; таким образом нет никакого способа определить, какой диапазон был фактически заблокирован, когда Вы указываете `fsFromLEOF`.
`ioPosOffset`	На вводе, смещении от основного расположения, указанного в `ioPosMode` поле для запуска заблокированного диапазона.

PBLockRangeAsync функционируйте блокирует часть файла, открытого с совместно используемым разрешением чтения-записи. Начало диапазона, который будет заблокирован, определяется ioPosMode и ioPosOffset поля. Конец диапазона, который будет заблокирован, определяется к началу диапазона и ioReqCount поле. Например, для блокировки первых 50 байтов в файле установить ioReqCount к 50, ioPosMode к fsFromStart, и ioPosOffset к 0.

PBLockRangeAsync функционируйте использует те же параметры в качестве обоих PBReadAsync и PBWriteAsync; путем вызова его сразу прежде PBReadAsync, можно использовать информацию в блоке параметра для PBReadAsync вызвать.

Когда Вы закончены с данными (обычно после вызова к PBWriteSync), можно вызвать PBUnlockRangeAsync освободить ту часть файла для последующего чтения и вызовов записи. Закрытие файла также выпускает все заблокированные диапазоны в том файле.

Специальные замечания

PBLockRangeAsync если файл указал в, функция ничего не делает ioRefNum поле открыто с совместно используемым разрешением чтения-записи, но не расположено на объеме удаленного сервера или не расположено под точкой доли на локальном томе с обеспечением совместного доступа. Чтобы проверить, включен ли совместный доступ к файлам в настоящее время, проверьте что bHasPersonalAccessPrivileges бит в vMAttrib поле GetVolParmsInfoBuffer возвращенный PBHGetVolParmsSync функция установлена.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    PBUnlockRangeSync
    PBUnlockRangeSync

(OS X v10.4)

Разблокировал часть файла.

Оператор осуждения

Использовать PBXUnlockRangeSync или FSUnlockRange вместо этого.

Объявление

Objective C

OSErr PBUnlockRangeSync ( ParmBlkPtr paramBlock );

Параметры


      paramBlock

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера. Если Вы вызываете PBUnlockRangeSync в файловой системе, не реализующей его — например, SMB —PBUnlockRangeSync возвраты noErr и ничего не делает.

Обсуждение

Соответствующие поля блока параметра:

`ioRefNum`	На вводе, числе ссылки на файл файла, владеющего диапазоном для разблокирования.
`ioReqCount`	На вводе, числе байтов в диапазоне.
`ioPosMode`	На вводе, постоянном указании основного расположения для запуска заблокированного диапазона. Посмотрите Константы Режима Позиции для получения дополнительной информации о константах, которые можно использовать для указания основного расположения.
`ioPosOffset`	На вводе, смещении от основного расположения, указанного в `ioPosMode` поле для запуска заблокированного диапазона.

PBUnlockRangeSync функция разблокировала часть файла, с которым Вы заблокировали PBLockRangeSync или PBLockRangeAsync. Начало диапазона, который будет разблокирован, определяется ioPosMode и ioPosOffset поля. Конец диапазона, который будет разблокирован, определяется к началу диапазона и ioReqCount поле. Например, для разблокирования первых 50 байтов в файле установить ioReqCount к 50, ioPosMode к fsFromStart, и ioPosOffset к 0. Диапазон байтов, которые будут разблокированы, должен быть тем же самым диапазоном, заблокированным предыдущим вызовом к PBLockRangeSync или PBLockRangeAsync.

Если по некоторым причинам необходимо разблокировать диапазон, начало которого или длина неизвестно, можно просто закрыть файл. Когда файл закрывается, все заблокированные диапазоны, сохраненные пользователем, разблокированы.

Специальные замечания

PBUnlockRangeSync если файл указал в, функция ничего не делает ioRefNum поле открыто с совместно используемым разрешением чтения-записи, но не расположено на объеме удаленного сервера или не расположено под точкой доли на локальном томе. Чтобы проверить, включен ли совместный доступ к файлам в настоящее время, проверьте что bHasPersonalAccessPrivileges бит в vMAttrib поле GetVolParmsInfoBuffer возвращенный PBHGetVolParmsSync функция установлена.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    PBUnlockRangeAsync
    PBUnlockRangeAsync

(OS X v10.4)

Разблокировал часть файла.

Оператор осуждения

Использовать PBXUnlockRangeAsync вместо этого.

Объявление

Objective C

OSErr PBUnlockRangeAsync ( ParmBlkPtr paramBlock );

Параметры


      paramBlock

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции. Если Вы вызываете `PBUnlockRangeAsync` в файловой системе, не реализующей его — например, SMB —`PBUnlockRangeAsync` возвраты `noErr` и ничего не делает.
`ioRefNum`	На вводе, числе ссылки на файл файла, владеющего диапазоном для разблокирования.
`ioReqCount`	На вводе, числе байтов в диапазоне.
`ioPosMode`	На вводе, постоянном указании основного расположения для запуска заблокированного диапазона. Посмотрите Константы Режима Позиции для получения дополнительной информации о константах, которые можно использовать для указания основного расположения.
`ioPosOffset`	На вводе, смещении от основного расположения, указанного в `ioPosMode` поле для запуска заблокированного диапазона.

PBUnlockRangeAsync функция разблокировала часть файла, с которым Вы заблокировали PBLockRangeSync или PBLockRangeAsync. Начало диапазона, который будет разблокирован, определяется ioPosMode и ioPosOffset поля. Конец диапазона, который будет разблокирован, определяется к началу диапазона и ioReqCount поле. Например, для разблокирования первых 50 байтов в файле установить ioReqCount к 50, ioPosMode к fsFromStart, и ioPosOffset к 0. Диапазон байтов, которые будут разблокированы, должен быть тем же самым диапазоном, заблокированным предыдущим вызовом к PBLockRangeSync или PBLockRangeAsync.

Специальные замечания

PBUnlockRangeAsync если файл указал в, функция ничего не делает ioRefNum поле открыто с совместно используемым разрешением чтения-записи, но не расположено на объеме удаленного сервера или не расположено под точкой доли на локальном томе. Чтобы проверить, включен ли совместный доступ к файлам в настоящее время, проверьте что bHasPersonalAccessPrivileges бит в vMAttrib поле GetVolParmsInfoBuffer возвращенный PBHGetVolParmsSync функция установлена.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.

Блокировка и разблокирование файлов и каталогов


    
    FSpSetFLock
    FSpSetFLock

(OS X v10.4)

Блокирует файл или каталог.

Оператор осуждения

Использовать FSSetCatalogInfo вместо этого.

Объявление

Objective C

OSErr FSpSetFLock ( const FSSpec *spec );

Параметры


      spec

Указатель на FSSpec структура, указывающая файл или каталог для блокировки. Посмотрите FSSpec для описания FSSpec тип данных.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Если PBHGetVolParmsSync или PBHGetVolParmsAsync функции указывают, что объем поддерживает блокировку папки (т.е. bHasFolderLock бит vMAttrib поле установлено), можно использовать FSpSetFLock заблокировать каталог. Иначе, можно только использовать эту функцию для блокировки файла.

После блокировки файла все новые пути доступа к тому файлу только для чтения. Эта функция не имеет никакого эффекта на существующие пути доступа.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    HSetFLock
    HSetFLock

(OS X v10.4)

Блокирует файл или каталог.

Оператор осуждения

Использовать FSSetCatalogInfo вместо этого.

Объявление

Objective C

OSErr HSetFLock ( FSVolumeRefNum vRefNum, SInt32 dirID, ConstStr255Param fileName );

Параметры

`vRefNum`	Ссылочный номер объема, управляйте числом, или 0 для объема по умолчанию.
`dirID`	Родительский каталог ID файла или каталога для блокировки.
`fileName`	Имя файла или каталога.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Если PBHGetVolParmsSync или PBHGetVolParmsAsync функция указывает, что объем поддерживает блокировку папки (т.е. bHasFolderLock бит vMAttrib поле установлено), можно использовать HSetFLock заблокировать каталог. Иначе, можно только использовать эту функцию для блокировки файла.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    PBHSetFLockSync
    PBHSetFLockSync

(OS X v10.4)

Блокирует файл или каталог.

Оператор осуждения

Использовать PBSetCatalogInfoSync вместо этого.

Объявление

Objective C

OSErr PBHSetFLockSync ( HParmBlkPtr paramBlock );

Параметры


      paramBlock

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioNamePtr`	На вводе, указателе на имя для файла или каталога для блокировки.
`ioVRefNum`	На вводе, ссылочном номере объема, числе диска, или 0 для объема по умолчанию.
`ioDirID`	На вводе, родительский каталог ID файла или каталога для блокировки.
`ioFVersNum`	На вводе это поле должно быть инициализировано для обнуления; если это поле не будет нулем, то вызов провалится к теперь устаревшему коду Macintosh File System (MFS), если объем получил доступ, объем MFS.

Если PBHGetVolParmsSync или PBHGetVolParmsAsync функция указывает, что объем поддерживает блокировку папки (т.е. bHasFolderLock бит vMAttrib поле установлено), можно использовать PBHSetFLockSync заблокировать каталог. Иначе, можно только использовать эту функцию для блокировки файла.

После блокировки файла все новые пути доступа к тому файлу только для чтения. Использующиеся в настоящее время пути доступа не затронуты.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    PBHSetFLockAsync
    PBHSetFLockAsync

(OS X v10.4)

Блокирует файл или каталог.

Оператор осуждения

Использовать PBSetCatalogInfoAsync вместо этого.

Объявление

Objective C

OSErr PBHSetFLockAsync ( HParmBlkPtr paramBlock );

Параметры


      paramBlock

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции.
`ioNamePtr`	На вводе, указателе на имя для файла или каталога для блокировки.
`ioVRefNum`	На вводе, ссылочном номере объема, числе диска, или 0 для объема по умолчанию.
`ioDirID`	На вводе, родительский каталог ID файла или каталога для блокировки.
`ioFVersNum`	На вводе это поле должно быть инициализировано для обнуления; если это поле не будет нулем, то вызов провалится к теперь устаревшему коду Macintosh File System (MFS), если объем получил доступ, объем MFS.

Если PBHGetVolParmsSync или PBHGetVolParmsAsync функция указывает, что объем поддерживает блокировку папки (т.е. bHasFolderLock бит vMAttrib поле установлено), можно использовать PBHSetFLockAsync заблокировать каталог. Иначе, можно только использовать эту функцию для блокировки файла.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    FSpRstFLock
    FSpRstFLock

(OS X v10.4)

Разблокировал файл или каталог.

Оператор осуждения

Использовать FSSetCatalogInfo вместо этого.

Объявление

Objective C

OSErr FSpRstFLock ( const FSSpec *spec );

Параметры


      spec

Указатель на FSSpec структура, указывающая файл для разблокирования. Посмотрите FSSpec для описания FSSpec тип данных.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Если PBHGetVolParmsSync или PBHGetVolParmsAsync функция указывает, что объем поддерживает блокировку папки (т.е. bHasFolderLock бит vMAttrib поле установлено), можно использовать FSpRstFLock разблокировать каталог. Иначе, можно только использовать эту функцию для разблокирования файла.

Можно заблокировать файл или каталог с FSpSetFLock , HSetFLock , PBHSetFLockSync , и PBHSetFLockAsync функции.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    HRstFLock
    HRstFLock

(OS X v10.4)

Разблокировал файл или каталог.

Оператор осуждения

Использовать FSSetCatalogInfo вместо этого.

Объявление

Objective C

OSErr HRstFLock ( FSVolumeRefNum vRefNum, SInt32 dirID, ConstStr255Param fileName );

Параметры

`vRefNum`	Ссылочный номер объема, управляйте числом, или 0 для объема по умолчанию.
`dirID`	Родительский каталог ID файла или каталога для разблокирования.
`fileName`	Имя файла или каталога.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Если PBHGetVolParmsSync или PBHGetVolParmsAsync функция указывает, что объем поддерживает блокировку папки (т.е. bHasFolderLock бит vMAttrib поле установлено), можно использовать HRstFLock разблокировать каталог. Иначе, можно только использовать эту функцию для разблокирования файла.

Можно заблокировать файл или каталог с FSpSetFLock , HSetFLock , PBHSetFLockSync , и PBHSetFLockAsync функции.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    PBHRstFLockSync
    PBHRstFLockSync

(OS X v10.4)

Разблокировал файл или каталог.

Оператор осуждения

Использовать PBSetCatalogInfoSync вместо этого.

Объявление

Objective C

OSErr PBHRstFLockSync ( HParmBlkPtr paramBlock );

Параметры


      paramBlock

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioNamePtr`	На вводе, указателе на имя для файла или каталога для разблокирования.
`ioVRefNum`	На вводе, ссылочном номере объема, числе диска, или 0 для объема по умолчанию.
`ioDirID`	На вводе, родительский каталог ID файла или каталога для разблокирования.
`ioFVersNum`	На вводе это поле должно быть инициализировано для обнуления; если это поле не будет нулем, то вызов провалится к теперь устаревшему коду Macintosh File System (MFS), если объем получил доступ, объем MFS.

Если PBHGetVolParmsSync или PBHGetVolParmsAsync функция указывает, что объем поддерживает блокировку папки (т.е. bHasFolderLock бит vMAttrib поле установлено), можно использовать PBHRstFLockSync разблокировать каталог. Иначе, можно только использовать эту функцию для разблокирования файла.

Использующиеся в настоящее время пути доступа не затронуты этой функцией.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    PBHRstFLockAsync
    PBHRstFLockAsync

(OS X v10.4)

Разблокировал файл или каталог.

Оператор осуждения

Использовать PBSetCatalogInfoAsync вместо этого.

Объявление

Objective C

OSErr PBHRstFLockAsync ( HParmBlkPtr paramBlock );

Параметры


      paramBlock

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции.
`ioNamePtr`	На вводе указатель на имя для файла или каталога o разблокировал.
`ioVRefNum`	На вводе, ссылочном номере объема, числе диска, или 0 для объема по умолчанию.
`ioDirID`	На вводе, родительский каталог ID файла или каталога для разблокирования.
`ioFVersNum`	На вводе это поле должно быть инициализировано для обнуления; если это поле не будет нулем, то вызов провалится к теперь устаревшему коду Macintosh File System (MFS), если объем получил доступ, объем MFS.

Если PBHGetVolParmsSync или PBHGetVolParmsAsync функция указывает, что объем поддерживает блокировку папки (т.е. bHasFolderLock бит vMAttrib поле установлено), можно использовать PBHRstFLockAsync разблокировать каталог. Иначе, можно только использовать эту функцию для разблокирования файла.

Использующиеся в настоящее время пути доступа не затронуты этой функцией.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.

Управление размером файла и ветвления


    
    FSGetForkSize
    FSGetForkSize

(OS X v10.8)

Возвращает размер открытого ветвления.

Оператор осуждения

На уровне POSIX/BSD использовать lseek вместо этого. Для получения размера ветви данных на уровне Foundation использовать NSFileHandle APIs вместо этого.

Объявление

Objective C

OSErr FSGetForkSize ( FSIORefNum forkRefNum, SInt64 *forkSize );

Параметры


      forkRefNum

Ссылочный номер открытого ветвления. Можно получить этот ссылочный номер ветвления с FSOpenFork функция или один из соответствующего параметра блокирует вызовы, PBOpenForkSync и PBOpenForkAsync.


      forkSize

По возврату, указателю на логический размер (логический конец файла) ветвления, в байтах. Размер возвратился, общее количество байтов, которые могут быть считаны из ветвления; сумма площади, фактически выделенной на объеме (физический размер), вероятно, будет больше.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Специальные замечания

Определить ли FSGetForkSize функция присутствует, вызовите Gestalt функция. Если FSGetForkSize присутствует, но непосредственно не поддерживается объемом, Файловый менеджер вызовет PBGetEOFSync; однако, Вы не будете в состоянии определить размер ветвления кроме ветви данных или ветви ресурсов, или ветвления, больше, чем 2 ГБ.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    PBGetForkSizeSync
    PBGetForkSizeSync

(OS X v10.8)

Возвращает размер открытого ветвления.

Оператор осуждения

Объявление

Objective C

OSErr PBGetForkSizeSync ( FSForkIOParam *paramBlock );

Параметры


      paramBlock

Указатель на ветвление блок параметра I/O. Посмотрите FSForkIOParam для описания FSForkIOParam тип данных.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:


      forkRefNum

На вводе, ссылочном номере открытого ветвления. Можно получить этот ссылочный номер ветвления с FSOpenFork функция или один из соответствующего параметра блокирует вызовы, PBOpenForkSync и PBOpenForkAsync.


      positionOffset

На выводе, логический размер (логический конец файла) ветвления, в байтах. Размер возвратился, общее количество байтов, которые могут быть считаны из ветвления; сумма площади, фактически выделенной на объеме (физический размер), вероятно, будет больше.

Специальные замечания

Определить ли PBGetForkSizeSync функция присутствует, вызовите Gestalt функция. Если PBGetForkSizeSync присутствует, но непосредственно не поддерживается объемом, Файловый менеджер вызовет PBGetEOFSync; однако, Вы не будете в состоянии определить размер ветвления кроме ветви данных или ветви ресурсов, или ветвления, больше, чем 2 ГБ.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    PBGetForkSizeAsync
    PBGetForkSizeAsync

(OS X v10.8)

Возвращает размер открытого ветвления.

Оператор осуждения

Объявление

Objective C

void PBGetForkSizeAsync ( FSForkIOParam *paramBlock );

Параметры


      paramBlock

Указатель на ветвление блок параметра I/O. Посмотрите FSForkIOParam для описания FSForkIOParam тип данных.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции.
`forkRefNum`	На вводе, ссылочном номере открытого ветвления. Можно получить этот ссылочный номер ветвления с `FSOpenFork` функция, или с одним из соответствующего параметра блокируют вызовы, `PBOpenForkSync` и `PBOpenForkAsync`.
`positionOffset`	На выводе, логический размер (логический конец файла) ветвления, в байтах. Размер возвратился, общее количество байтов, которые могут быть считаны из ветвления; сумма площади, фактически выделенной на объеме (физический размер), вероятно, будет больше.

Специальные замечания

Определить ли PBGetForkSizeAsync функция присутствует, вызовите Gestalt функция. Если PBGetForkSizeAsync присутствует, но непосредственно не поддерживается объемом, Файловый менеджер вызовет PBGetEOFAsync; однако, Вы не будете в состоянии определить размер ветвления кроме ветви данных или ветви ресурсов, или ветвления, больше, чем 2 ГБ.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    FSSetForkSize
    FSSetForkSize

(OS X v10.8)

Изменяет размер открытого ветвления.

Оператор осуждения

На уровне POSIX/BSD использовать ftruncate вместо этого. Для изменения размера ветви данных на уровне Foundation использовать NSFileHandle APIs вместо этого.

Объявление

Objective C

OSErr FSSetForkSize ( FSIORefNum forkRefNum, UInt16 positionMode, SInt64 positionOffset );

Параметры

`forkRefNum`	Ссылочный номер открытого ветвления. Можно получить этот ссылочный номер ветвления с `FSOpenFork` функция или один из соответствующего параметра блокирует вызовы, `PBOpenForkSync` и `PBOpenForkAsync`.
`positionMode`	Постоянное указание основного расположения в ветвлении для нового размера. Посмотрите Константы Режима Позиции для получения дополнительной информации о константах, которые можно использовать для указания основного расположения.
`positionOffset`	Смещение нового размера от основного расположения, указанного в `positionMode` параметр.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера. Если существует недостаточно пространства на объеме для расширения ветвления, то dskFulErr возвращается и размер ветвления неизменен.

Обсуждение

FSSetForkSize функционируйте устанавливает логический конец файла позиции, обозначенной positionMode и positionOffset параметры. Новый размер ветвления может быть меньше, чем, равный, или больше, чем текущий размер ветвления. Если новый размер ветвления будет больше, чем текущий размер ветвления, то дополнительные байты, между старым и новым размером, будут иметь неопределенное значение.

Если текущая позиция ветвления будет больше, чем новый размер ветвления, то текущая позиция будет установлена в новый размер ветвления, текущая позиция будет равна логическому концу файла.

Специальные замечания

Вы не должны проверять, что объем поддерживает FSSetForkSize функция. Если объем не поддерживает FSSetForkSize функция, но FSSetForkSize функция присутствует, Файловый менеджер автоматически вызывает PBSetEOFSync функционируйте и переводит между вызовами соответственно.

Отметьте, однако, это, если объем не поддерживает FSSetForkSize функция, можно только получить доступ к ветвям данных и ветвям ресурсов, и Вы не можете увеличить ветвление вне 2 ГБ. Проверять что FSSetForkSize функция присутствует, вызовите Gestalt функция.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    PBSetForkSizeSync
    PBSetForkSizeSync

(OS X v10.8)

Изменяет размер открытого ветвления.

Оператор осуждения

Объявление

Objective C

OSErr PBSetForkSizeSync ( FSForkIOParam *paramBlock );

Параметры


      paramBlock

Указатель на ветвление блок параметра I/O. Посмотрите FSForkIOParam для описания FSForkIOParam тип данных.

Возвращаемое значение

Обсуждение

Соответствующие поля блока параметра:

`forkRefNum`	На вводе, ссылочном номере открытого ветвления. Можно получить ссылочный номер ветвления с `FSOpenFork` функция или один из соответствующего параметра блокирует вызовы, `PBOpenForkSync` и `PBOpenForkAsync`.
`positionMode`	На вводе, постоянном указании основного расположения в ветвлении для нового размера. Посмотрите Константы Режима Позиции для получения дополнительной информации о константах, которые можно использовать для указания основного расположения.
`positionOffset`	На вводе, смещении нового размера от основного расположения, указанного в `positionMode` поле.

PBSetForkSizeSync функционируйте устанавливает логический конец файла позиции, обозначенной positionMode и positionOffset поля. Новый размер ветвления может быть меньше, чем, равный, или больше, чем текущий размер ветвления. Если новый размер ветвления будет больше, чем текущий размер ветвления, то дополнительные байты, между старым и новым размером, будут иметь неопределенное значение.

Если текущая позиция ветвления будет больше, чем новый размер ветвления, то текущая позиция будет установлена в новый размер ветвления. Т.е. текущая позиция будет равна логическому концу файла.

Специальные замечания

Вы не должны проверять, что объем поддерживает PBSetForkSizeSync функция. Если объем не поддерживает PBSetForkSizeSync функция, но PBSetForkSizeSync функция присутствует, Файловый менеджер автоматически вызывает PBSetEOFSync функционируйте и переводит между вызовами соответственно.

Отметьте, однако, это, если объем не поддерживает PBSetForkSizeSync функция, можно только получить доступ к ветвям данных и ветвям ресурсов, и Вы не можете увеличить ветвление вне 2 ГБ. Проверять что PBSetForkSizeSync функция присутствует, вызовите Gestalt функция.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    PBSetForkSizeAsync
    PBSetForkSizeAsync

(OS X v10.8)

Изменяет размер открытого ветвления.

Оператор осуждения

Объявление

Objective C

void PBSetForkSizeAsync ( FSForkIOParam *paramBlock );

Параметры


      paramBlock

Указатель на ветвление блок параметра I/O. Посмотрите FSForkIOParam для описания FSForkIOParam тип данных.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции. Если существует недостаточно пространства на объеме для расширения ветвления, то `dskFulErr` возвращается и размер ветвления неизменен.
`forkRefNum`	На вводе, ссылочном номере открытого ветвления. Можно получить ссылочный номер ветвления с `FSOpenFork` функция, или с одним из соответствующего параметра блокируют вызовы, `PBOpenForkSync` и `PBOpenForkAsync`.
`positionMode`	На вводе, постоянном указании основного расположения в ветвлении для нового размера. Посмотрите Константы Режима Позиции для получения дополнительной информации о константах, которые можно использовать для указания основного расположения.
`positionOffset`	На вводе, смещении нового размера от основного расположения, указанного в `positionMode` поле.

PBSetForkSizeAsync функционируйте устанавливает логический конец файла позиции, обозначенной positionMode и positionOffset поля. Новый размер ветвления может быть меньше, чем, равный, или больше, чем текущий размер ветвления. Если новый размер ветвления будет больше, чем текущий размер ветвления, то дополнительные байты, между старым и новым размером, будут иметь неопределенное значение.

Специальные замечания

Вы не должны проверять, что объем поддерживает PBSetForkSizeAsync функция. Если объем не поддерживает PBSetForkSizeAsync функция, но PBSetForkSizeAsync функция присутствует, Файловый менеджер автоматически вызывает PBSetEOFAsync функционируйте и переводит между вызовами соответственно.

Отметьте, однако, это, если объем не поддерживает PBSetForkSizeAsync функция, можно только получить доступ к ветвям данных и ветвям ресурсов, и Вы не можете увеличить ветвление вне 2 ГБ. Проверять что PBSetForkSizeAsync функция присутствует, вызовите Gestalt функция.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    GetEOF
    GetEOF

(OS X v10.4)

Определяет текущий логический размер открытого файла.

Оператор осуждения

Использовать FSGetForkSize вместо этого.

Объявление

Objective C

OSErr GetEOF ( FSIORefNum refNum, SInt32 *logEOF );

Параметры

`refNum`	Число ссылки на файл открытого файла.
`logEOF`	По возврату, указателю на логический размер (логический конец файла) данного файла.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Определить размер именованного ветвления кроме ветвей данных или ветвей ресурсов, или ветвления, больше, чем 2 ГБ, использование FSGetForkSize функция или один из соответствующего параметра блокирует функции, PBGetForkSizeSync и PBGetForkSizeAsync.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    PBGetEOFSync
    PBGetEOFSync

(OS X v10.4)

Определяет текущий логический размер открытого файла.

Оператор осуждения

Использовать PBGetForkSizeSync вместо этого.

Объявление

Objective C

OSErr PBGetEOFSync ( ParmBlkPtr paramBlock );

Параметры


      paramBlock

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioRefNum`	На вводе, числе ссылки на файл для открытого файла.
`ioMisc`	На выводе, указателе на логический размер (логический конец файла) данного файла. Поскольку `ioMisc` поле имеет тип `Ptr`, необходимо будет принудить значение к длинному целому для интерпретации значения правильно.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    PBGetEOFAsync
    PBGetEOFAsync

(OS X v10.4)

Определяет текущий логический размер открытого файла.

Оператор осуждения

Использовать PBGetForkSizeAsync вместо этого.

Объявление

Objective C

OSErr PBGetEOFAsync ( ParmBlkPtr paramBlock );

Параметры


      paramBlock

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции.
`ioRefNum`	На вводе, числе ссылки на файл для открытого файла.
`ioMisc`	На выводе, логический размер (логический конец файла) данного файла. Поскольку `ioMisc` поле имеет тип `Ptr`, необходимо будет принудить значение к длинному целому для интерпретации значения правильно.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    SetEOF
    SetEOF

(OS X v10.4)

Устанавливает логический размер открытого файла.

Оператор осуждения

Использовать FSSetForkSize вместо этого.

Объявление

Objective C

OSErr SetEOF ( FSIORefNum refNum, SInt32 logEOF );

Параметры


      refNum

Число ссылки на файл открытого файла.


      logEOF

Новый логический размер (логический конец файла) данного файла. Если Вы устанавливаете logEOF параметр к 0, все место, занятое файлом на объеме, выпущен. Файл все еще существует, но он содержит 0 байтов. Установка конца файла ветвления файла 0 является поэтому не тем же как удалением файла, удаляющего оба ветвления файла сразу.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

При попытке установить логический конец файла вне физического конца файла, физический конец файла установлен 1 байт вне конца следующего свободного блока выделения, если нет достаточного количества пространства на объеме, никакое изменение не внесено, и SetEOF возвраты dskFulErr как его функциональный результат.

Чтобы гарантировать, что Ваши изменения в файле записаны в диск, вызовите одну из функций, FlushVol , PBFlushVolSync , или PBFlushVolAsync. Чтобы установить размер именованного ветвления кроме ветвей данных и ветвей ресурсов, или увеличить размер файла вне 2 ГБ, необходимо использовать FSSetForkSize функция или один из соответствующего параметра блокирует вызовы, PBSetForkSizeSync и PBSetForkSizeAsync.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    PBSetEOFSync
    PBSetEOFSync

(OS X v10.4)

Устанавливает логический размер открытого файла.

Оператор осуждения

Использовать PBSetForkSizeSync вместо этого.

Объявление

Objective C

OSErr PBSetEOFSync ( ParmBlkPtr paramBlock );

Параметры


      paramBlock

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:


      ioRefNum

На вводе, числе ссылки на файл для открытого файла.


      ioMisc

На вводе, новый логический размер (логический конец файла) данного файла. Поскольку ioMisc поле имеет тип Ptr, необходимо принудить требуемое значение от длинного целого для ввода Ptr. Если значение ioMisc поле 0, все пространство, занятое файлом на объеме, освобождено. Файл все еще существует, но он содержит 0 байтов. Установка конца файла ветвления файла 0 является поэтому не тем же как удалением файла, удаляющего оба ветвления файла сразу.

При попытке установить логический конец файла вне текущего физического конца файла, другой блок выделения добавляется к файлу, если нет достаточного количества пространства на объеме, никакое изменение не внесено и PBSetEOFSync возвраты dskFulErr как его функциональный результат.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    PBSetEOFAsync
    PBSetEOFAsync

(OS X v10.4)

Устанавливает логический размер открытого файла.

Оператор осуждения

Использовать PBSetForkSizeAsync вместо этого.

Объявление

Objective C

OSErr PBSetEOFAsync ( ParmBlkPtr paramBlock );

Параметры


      paramBlock

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции.
`ioRefNum`	На вводе, числе ссылки на файл для открытого файла.
`ioMisc`	На вводе, новый логический размер (логический конец файла) данного файла. Поскольку `ioMisc` поле имеет тип `Ptr`, необходимо принудить требуемое значение от длинного целого для ввода `Ptr`. Если значение `ioMisc` поле 0, все пространство, занятое файлом на объеме, освобождено. Файл все еще существует, но он содержит 0 байтов. Установка конца файла ветвления файла 0 является поэтому не тем же как удалением файла, удаляющего оба ветвления файла сразу.

При попытке установить логический конец файла вне текущего физического конца файла, другой блок выделения добавляется к файлу, если нет достаточного количества пространства на объеме, никакое изменение не внесено и PBSetEOFAsync возвраты dskFulErr как его функциональный результат.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.

Управление позицией файла


    
    FSGetForkPosition
    FSGetForkPosition

(OS X v10.8)

Возвращает текущую позицию открытого ветвления.

Оператор осуждения

На уровне POSIX/BSD использовать lseek с SEEK_CUR и смещение 0. Для получения позиции ветви данных на уровне Foundation использовать NSFileHandle APIs вместо этого.

Объявление

Objective C

OSErr FSGetForkPosition ( FSIORefNum forkRefNum, SInt64 *position );

Параметры

`forkRefNum`	Ссылочный номер ветвления, ранее открытого `FSOpenFork` функционируйте или один из его соответствующих блочных вызовов параметра, `PBOpenForkSync` и `PBOpenForkAsync`.
`position`	По возврату, указателю на текущую позицию ветвления. Возвращенная позиция ветвления относительно запуска ветвления (т.е. это - абсолютное смещение в байтах).

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Специальные замечания

Прежде, чем вызвать FSGetForkPosition функция, вызовите Gestalt функция с gestaltFSAttr селектор, чтобы определить, если FSGetForkPosition доступно. Если функция будет доступна, но не будет непосредственно поддерживаться объемом, то Файловый менеджер автоматически вызовет PBGetFPosSync; однако, Вы не будете в состоянии определить позицию ветвления именованного ветвления кроме ветви данных или ветви ресурсов, или ветвления, больше, чем 2 ГБ.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    PBGetForkPositionSync
    PBGetForkPositionSync

(OS X v10.8)

Возвращает текущую позицию открытого ветвления.

Оператор осуждения

Объявление

Objective C

OSErr PBGetForkPositionSync ( FSForkIOParam *paramBlock );

Параметры


      paramBlock

Указатель на ветвление блок параметра I/O. Посмотрите FSForkIOParam для описания FSForkIOParam тип данных.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`forkRefNum`	На вводе, ссылочном номере ветвления, ранее открытого `FSOpenFork` , `PBOpenForkSync` или `PBOpenForkAsync` функция.
`positionOffset`	На выводе, текущей позиции ветвления. Возвращенная позиция ветвления относительно запуска ветвления (т.е. это - абсолютное смещение в байтах).

Специальные замечания

Прежде, чем вызвать PBGetForkPositionSync функция, вызовите Gestalt функция с gestaltFSAttr селектор, чтобы определить, если PBGetForkPositionSync доступно. Если функция будет доступна, но не будет непосредственно поддерживаться объемом, то Файловый менеджер автоматически вызовет PBGetFPosSync; однако, Вы не будете в состоянии определить позицию ветвления именованного ветвления кроме ветви данных или ветви ресурсов, или ветвления, больше, чем 2 ГБ.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    PBGetForkPositionAsync
    PBGetForkPositionAsync

(OS X v10.8)

Возвращает текущую позицию открытого ветвления.

Оператор осуждения

Объявление

Objective C

void PBGetForkPositionAsync ( FSForkIOParam *paramBlock );

Параметры


      paramBlock

Указатель на ветвление блок параметра I/O. Посмотрите FSForkIOParam для описания FSForkIOParam тип данных.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции.
`forkRefNum`	На вводе, ссылочном номере ветвления, ранее открытого `FSOpenFork` , `PBOpenForkSync` , или `PBOpenForkAsync` функция.
`positionOffset`	На выводе, текущей позиции ветвления. Возвращенная позиция ветвления относительно запуска ветвления (т.е. это - абсолютное смещение в байтах).

Специальные замечания

Прежде, чем вызвать PBGetForkPositionAsync функция, вызовите Gestalt функция с gestaltFSAttr селектор, чтобы определить, если PBGetForkPositionAsync доступно. Если функция будет доступна, но не будет непосредственно поддерживаться объемом, то Файловый менеджер автоматически вызовет PBGetFPosAsync; однако, Вы не будете в состоянии определить позицию ветвления именованного ветвления кроме ветви данных или ветви ресурсов, или ветвления, больше, чем 2 ГБ.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    FSSetForkPosition
    FSSetForkPosition

(OS X v10.8)

Устанавливает текущую позицию открытого ветвления.

Оператор осуждения

На уровне POSIX/BSD использовать lseek вместо этого. Для установки позиции ветви данных на уровне Foundation использовать NSFileHandle APIs вместо этого.

Объявление

Objective C

OSErr FSSetForkPosition ( FSIORefNum forkRefNum, UInt16 positionMode, SInt64 positionOffset );

Параметры

`forkRefNum`	Ссылочный номер ветвления, ранее открытого `FSOpenFork`, `PBOpenForkSync`, или `PBOpenForkAsync` функция.
`positionMode`	Постоянное указание основного расположения в ветвлении для новой позиции. Если этот параметр равен `fsAtMark`, тогда `positionOffset` параметр проигнорирован. Посмотрите Константы Режима Позиции для описания констант, которые можно использовать для указания основного расположения.
`positionOffset`	Смещение новой позиции от основного расположения, указанного в `positionMode` параметр.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера. Эта функция возвращает код результата posErr при попытке установить текущую позицию ветвления к смещению перед запуском файла.

Специальные замечания

Определить если FSSetForkPosition функция присутствует, вызовите Gestalt функция с gestaltFSAttr селектор. Если FSSetForkPosition функция присутствует, но объем непосредственно не поддерживает ее, Файловый менеджер автоматически вызовет PBSetFPosSync функция. Однако, если объем непосредственно не поддерживает FSSetForkPosition функция, можно только установить позицию файла для ветвей данных и ветвей ресурсов, и Вы не можете увеличить эти файлы вне 2 ГБ.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    PBSetForkPositionSync
    PBSetForkPositionSync

(OS X v10.8)

Устанавливает текущую позицию открытого ветвления.

Оператор осуждения

Объявление

Objective C

OSErr PBSetForkPositionSync ( FSForkIOParam *paramBlock );

Параметры


      paramBlock

Указатель на ветвление блок параметра I/O. Посмотрите FSForkIOParam для описания FSForkIOParam тип данных.

Возвращаемое значение

Обсуждение

Соответствующие поля блока параметра:

`forkRefNum`	На вводе, ссылочном номере ветвления, ранее открытого `FSOpenFork` , `PBOpenForkSync` , или `PBOpenForkAsync` функция.
`positionMode`	На вводе, постоянном указании основного расположения в ветвлении для новой позиции. Если это поле равно `fsAtMark`, тогда `positionOffset` поле проигнорировано. Посмотрите Константы Режима Позиции для описания констант, которые можно использовать для указания основного расположения.
`positionOffset`	На вводе, смещении новой позиции от основного расположения, указанного в `positionMode` поле.

Специальные замечания

Определить если PBSetForkPositionSync функция присутствует, вызовите Gestalt функция с gestaltFSAttr селектор. Если PBSetForkPositionSync функция присутствует, но объем непосредственно не поддерживает ее, Файловый менеджер автоматически вызовет PBSetFPosSync функция. Однако, если объем непосредственно не поддерживает PBSetForkPositionSync функция, можно только установить позицию файла для ветвей данных и ветвей ресурсов, и Вы не можете увеличить эти файлы вне 2 ГБ.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    PBSetForkPositionAsync
    PBSetForkPositionAsync

(OS X v10.8)

Устанавливает текущую позицию открытого ветвления.

Оператор осуждения

Объявление

Objective C

void PBSetForkPositionAsync ( FSForkIOParam *paramBlock );

Параметры


      paramBlock

Указатель на ветвление блок параметра I/O. Посмотрите FSForkIOParam для описания FSForkIOParam тип данных.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции. Эта функция возвращает код результата `posErr` при попытке установить текущую позицию ветвления к смещению перед запуском файла.
`forkRefNum`	На вводе, ссылочном номере ветвления, ранее открытого `FSOpenFork` , `PBOpenForkSync` , или `PBOpenForkAsync` функция.
`positionMode`	На вводе, постоянном указании основного расположения в ветвлении для новой позиции. Если это поле равно `fsAtMark`, тогда `positionOffset` поле проигнорировано. Посмотрите Константы Режима Позиции для описания констант, которые можно использовать для указания основного расположения.
`positionOffset`	На вводе, смещении новой позиции от основного расположения, указанного в `positionMode` поле.

Специальные замечания

Определить если PBSetForkPositionAsync функция присутствует, вызовите Gestalt функция с gestaltFSAttr селектор. Если PBSetForkPositionAsync функция присутствует, но объем непосредственно не поддерживает ее, Файловый менеджер автоматически вызовет PBSetFPosAsync функция. Однако, если объем непосредственно не поддерживает PBSetForkPositionAsync функция, можно только установить позицию файла для ветвей данных и ветвей ресурсов, и Вы не можете увеличить эти файлы вне 2 ГБ.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    GetFPos
    GetFPos

(OS X v10.4)

Возвращает текущую позицию метки файла.

Оператор осуждения

Использовать FSGetForkPosition вместо этого.

Объявление

Objective C

OSErr GetFPos ( FSIORefNum refNum, SInt32 *filePos );

Параметры

`refNum`	Число ссылки на файл открытого файла.
`filePos`	По возврату, указателю на текущую позицию метки. Значение позиции основано на нуле; т.е. значение `filePos` если метка файла расположена в начале файла, 0.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Поскольку операции чтения и операции записи выполняются функциями FSRead и FSWrite начните в текущей метке, необходимо вызвать GetFPos, или один из параметра блокирует функции, PBGetFPosSync и PBGetFPosAsync , определить текущую позицию метки файла прежде, чем читать из или записать в файл.

Определить текущую позицию именованного ветвления, или ветвления, больше, чем 2 ГБ, использование FSGetForkPosition функция или один из соответствующего параметра блокирует вызовы, PBGetForkPositionSync и PBGetForkPositionAsync.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    PBGetFPosSync
    PBGetFPosSync

(OS X v10.4)

Возвращает текущую позицию метки файла.

Оператор осуждения

Использовать PBGetForkPositionSync вместо этого.

Объявление

Objective C

OSErr PBGetFPosSync ( ParmBlkPtr paramBlock );

Параметры


      paramBlock

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioRefNum`	На вводе, числе ссылки на файл открытого файла.
`ioPosOffset`	На выводе, текущей позиции метки. Значение возвратилось в `ioPosOffset` основано на нуле. Таким образом, вызов к `PBGetFPosSync` возвраты 0, если Вы вызываете его, когда метка файла расположена в начале файла.

ioReqCount, ioActCount, и ioPosMode поля блока параметра все установлены в 0 на выводе.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    PBGetFPosAsync
    PBGetFPosAsync

(OS X v10.4)

Возвращает текущую позицию метки файла.

Оператор осуждения

Использовать PBGetForkPositionAsync вместо этого.

Объявление

Objective C

OSErr PBGetFPosAsync ( ParmBlkPtr paramBlock );

Параметры


      paramBlock

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения, посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции.
`ioRefNum`	На вводе, числе ссылки на файл открытого файла.
`ioPosOffset`	На выводе, текущей позиции метки. Значение возвратилось в `ioPosOffset` основано на нуле. Таким образом, вызов к `PBGetFPosAsync` возвраты 0, если Вы вызываете его, когда метка файла расположена в начале файла. `ioReqCount`, `ioActCount`, и `ioPosMode` поля блока параметра все установлены в 0 на выводе. Определить текущую позицию именованного ветвления, или ветвления, больше, чем 2 ГБ, использование `FSGetForkPosition` функция или один из соответствующего параметра блокирует вызовы, `PBGetForkPositionSync` и `PBGetForkPositionAsync`.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    SetFPos
    SetFPos

(OS X v10.4)

Устанавливает позицию метки файла.

Оператор осуждения

Использовать FSSetForkPosition вместо этого.

Объявление

Objective C

OSErr SetFPos ( FSIORefNum refNum, SInt16 posMode, SInt32 posOff );

Параметры

`refNum`	Число ссылки на файл открытого файла.
`posMode`	Постоянное указание, как расположить метку файла; этот параметр должен содержать одно из значений, описанных в Константах Режима Позиции.
`posOff`	Смещение от основного расположения, указанного `posMode` параметр для нового файла отмечает позицию. Если Вы указываете `fsFromLEOF` в `posMode` параметр, значение в `posOff` параметр должен быть меньше чем или равен 0. Если Вы указываете `fsAtMark`, значение в `posOff` параметр проигнорирован.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Поскольку операции чтения и операции записи выполняются функциями FSRead и FSWrite начните в текущей метке, можно хотеть вызвать SetFPos изменить местоположение метки файла прежде, чем читать из или записать в файл.

Установить позицию метки файла для именованного ветвления кроме ветвей данных и ветвей ресурсов, или расположить метку файла в точку больше чем 2 ГБ в файл, использование FSSetForkPosition функция или один из соответствующего параметра блокирует вызовы, PBSetForkPositionSync и PBSetForkPositionAsync.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    PBSetFPosSync
    PBSetFPosSync

(OS X v10.4)

Устанавливает позицию метки файла.

Оператор осуждения

Использовать PBSetForkPositionSync вместо этого.

Объявление

Objective C

OSErr PBSetFPosSync ( ParmBlkPtr paramBlock );

Параметры


      paramBlock

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioRefNum`	На вводе, числе ссылки на файл для открытого файла.
`ioPosMode`	На вводе, постоянном указании, как расположить метку файла; это поле должно содержать одно из значений, описанных в Константах Режима Позиции.
`ioPosOffset`	На вводе, смещении от основного расположения, указанного `ioPosMode` поле для метки файла. Если Вы указываете `fsAtMark` в `ioPosMode` поле, метку оставляют везде, где это в настоящее время располагается и значение в `ioPosOffset` поле проигнорировано. Если Вы указываете `fsFromLEOF`, значение в `ioPosOffset` должно быть меньше чем или равно 0. На выводе, позиции, в которой была фактически установлена метка.

PBSetFPosSync функционируйте устанавливает метку указанного файла к позиции, указанной ioPosMode и ioPosOffset поля. При попытке установить метку мимо логического конца файла, PBSetFPosSync перемещает метку до конца файла и возвраты eofErr как его функциональный результат.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    PBSetFPosAsync
    PBSetFPosAsync

(OS X v10.4)

Устанавливает позицию метки файла.

Оператор осуждения

Использовать PBSetForkPositionAsync вместо этого.

Объявление

Objective C

OSErr PBSetFPosAsync ( ParmBlkPtr paramBlock );

Параметры


      paramBlock

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции.
`ioRefNum`	На вводе, числе ссылки на файл для открытого файла.
`ioPosMode`	На вводе, постоянном указании, как расположить метку; это поле должно содержать одно из значений, описанных в Константах Режима Позиции.
`ioPosOffset`	На вводе, смещении от основного расположения, указанного `ioPosMode` поле для метки файла. Если Вы указываете `fsAtMark` в `ioPosMode` поле, метку оставляют везде, где это в настоящее время располагается и значение в `ioPosOffset` поле проигнорировано. Если Вы указываете `fsFromLEOF`, значение в `ioPosOffset` должно быть меньше чем или равно 0. На выводе, позиции, в которой была фактически установлена метка.

PBSetFPosAsync функционируйте устанавливает метку указанного файла к позиции, указанной ioPosMode и ioPosOffset поля. При попытке установить метку мимо логического конца файла, PBSetFPosAsync перемещает метку до конца файла и возвраты eofErr как его функциональный результат.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.

Управление объемом по умолчанию


    
    HGetVol
    HGetVol

(OS X v10.4)

Определяет текущий объем по умолчанию и каталог по умолчанию.

Оператор осуждения

Нет никакой заменяющей функции.

Объявление

Objective C

OSErr HGetVol ( StringPtr volName, FSVolumeRefNum *vRefNum, SInt32 *dirID );

Параметры

`volName`	По возврату, указателю на имя объема по умолчанию. Если Вы не хотите имя возвращенного объема по умолчанию, установите этот параметр на `NULL`.
`vRefNum`	По возврату, указателю на ссылочный номер объема объема по умолчанию.
`dirID`	По возврату, указателю на каталог ID каталога по умолчанию.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    PBHGetVolSync
    PBHGetVolSync

(OS X v10.4)

Определяет объем по умолчанию и каталог по умолчанию.

Оператор осуждения

Нет никакой заменяющей функции.

Объявление

Objective C

OSErr PBHGetVolSync ( WDPBPtr paramBlock );

Параметры


      paramBlock

Указатель на рабочий блок параметра каталога. Посмотрите WDPBRec для описания WDPBRec тип данных.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

PBHGetVolSync функционируйте возвращает объем по умолчанию и каталог, в последний раз установленный вызовом в HSetVol или PBHSetVolSync. Соответствующие поля блока параметра:

`ioNamePtr`	На выводе, указателе на имя объема по умолчанию. Передайте указатель на a `Str31` оцените, если Вы хотите то возвращенное имя. Если Вы передаете `NULL` в этом поле не возвращается никакое имя тома.
`ioVRefNum`	На выводе, ссылочном номере объема объема по умолчанию.
`ioWDProcID`	На выводе, рабочем идентификаторе пользователя каталога.
`ioWDVRefNum`	На выводе, ссылочном номере объема объема, на котором существует каталог по умолчанию.
`ioWDDirID`	На выводе, каталоге ID каталога по умолчанию.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    PBHGetVolAsync
    PBHGetVolAsync

(OS X v10.4)

Определяет объем по умолчанию и каталог по умолчанию.

Оператор осуждения

Нет никакой заменяющей функции.

Объявление

Objective C

OSErr PBHGetVolAsync ( WDPBPtr paramBlock );

Параметры


      paramBlock

Указатель на рабочий блок параметра каталога. Посмотрите WDPBRec для описания WDPBRec тип данных.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

PBHGetVolAsync функционируйте возвращает объем по умолчанию и каталог, в последний раз установленный вызовом в HSetVol или PBHSetVolSync. Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции.
`ioNamePtr`	На выводе, указателе на имя объема по умолчанию. Необходимо передать указатель на a `Str31` оцените, если Вы хотите то возвращенное имя. Если Вы передаете `NULL` в этом поле не возвращается никакое имя тома.
`ioVRefNum`	На выводе, ссылочном номере объема объема по умолчанию.
`ioWDProcID`	На выводе, рабочем идентификаторе пользователя каталога.
`ioWDVRefNum`	На выводе, ссылочном номере объема объема, на котором существует каталог по умолчанию.
`ioWDDirID`	На выводе, каталоге ID каталога по умолчанию.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    HSetVol
    HSetVol

(OS X v10.4)

Регулирует громкость по умолчанию и каталог по умолчанию.

Оператор осуждения

Нет никакой заменяющей функции.

Объявление

Objective C

OSErr HSetVol ( ConstStr63Param volName, FSVolumeRefNum vRefNum, SInt32 dirID );

Параметры

`volName`	Имя смонтированного объема или частичный путь каталога. Этот параметр может быть `NULL`.
`vRefNum`	Ссылочный номер объема, управляйте числом, или 0 для объема по умолчанию.
`dirID`	Каталог ID.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

HSetVol функция позволяет Вам указать каталог по умолчанию ссылочным номером объема или каталогом ID.

И объем по умолчанию и каталог по умолчанию используются в вызовах, выполненных без имени тома, ссылочного номера объема 0 и каталога ID 0.

Специальные замечания

Использование HSetVol если Ваше приложение может выполниться в версиях системного программного обеспечения до версии 7.0, функции обескураживают. Поскольку указанный каталог не мог бы самостоятельно быть рабочим каталогом, HSetVol записывает объем по умолчанию и каталог отдельно, с помощью ссылочного номера объема объема и фактического каталога ID указанного каталога. Последующие вызовы к GetVol (или PBGetVolSync или PBGetVolAsync) возвратите только ссылочный номер объема, который заставит корневой каталог того объема (а не каталог по умолчанию, как ожидалось) быть полученным доступ.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    PBHSetVolSync
    PBHSetVolSync

(OS X v10.4)

Регулирует громкость по умолчанию и каталог по умолчанию.

Оператор осуждения

Нет никакой заменяющей функции.

Объявление

Objective C

OSErr PBHSetVolSync ( WDPBPtr paramBlock );

Параметры


      paramBlock

Указатель на рабочий блок параметра каталога. Посмотрите WDPBRec для описания WDPBRec тип данных.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioNamePtr`	На вводе, указателе на путь. Если это поле указывает полный путь, громкость по умолчанию регулируется к объему, имя которого содержится в том пути. (Полный путь переопределяет `ioVRefNum` поле.), Если это поле содержит частичный путь и `ioVRefNum` поле указывает ссылочный номер объема, тогда каталог по умолчанию установлен в каталог, указывающий частичный путь здесь в каталоге, сданном `ioWDDirID` поле. Если это поле `NULL`, тогда каталог по умолчанию установлен в каталог, указывающий ID в `ioWDDirID` поле.
`ioVRefNum`	На вводе, ссылочном номере объема для объема по умолчанию. Это поле проигнорировано если `ioNamePtr` поле указывает полный путь.
`ioWDDirID`	На вводе, каталоге ID. Если `ioVRefNum` поле содержит ссылочный номер объема и `ioNamePtr` содержит частичный путь, это поле содержит каталог ID каталога, содержащего каталог по умолчанию. Если `ioNamePtr` `NULL`, это поле содержит каталог ID каталога по умолчанию.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    PBHSetVolAsync
    PBHSetVolAsync

(OS X v10.4)

Регулирует громкость по умолчанию и каталог по умолчанию.

Оператор осуждения

Нет никакой заменяющей функции.

Объявление

Objective C

OSErr PBHSetVolAsync ( WDPBPtr paramBlock );

Параметры


      paramBlock

Указатель на рабочий блок параметра каталога. Посмотрите WDPBRec для описания WDPBRec тип данных.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции.
`ioNamePtr`	На вводе, указателе на путь. Если это поле указывает полный путь, громкость по умолчанию регулируется к объему, имя которого содержится в том пути. (Полный путь переопределяет `ioVRefNum` поле.), Если это поле содержит частичный путь и `ioVRefNum` поле указывает ссылочный номер объема, тогда каталог по умолчанию установлен в каталог, указывающий частичный путь здесь в каталоге, сданном `ioWDDirID` поле. Если это поле `NULL`, тогда каталог по умолчанию установлен в каталог, указывающий ID в `ioWDDirID` поле.
`ioVRefNum`	На вводе, ссылочном номере объема для объема по умолчанию. Это поле проигнорировано если `ioNamePtr` поле указывает полный путь.
`ioWDDirID`	На вводе, каталоге ID. Если `ioVRefNum` поле содержит ссылочный номер объема и `ioNamePtr` содержит частичный путь, это поле содержит каталог ID каталога, содержащего каталог по умолчанию. Если `ioNamePtr` `NULL`, это поле содержит каталог ID каталога по умолчанию.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.

Монтирование и размонтирование объемов


    
    FSMountLocalVolumeSync
    FSMountLocalVolumeSync

(OS X v10.8)

Монтирует объем.

Оператор осуждения

Чтобы смонтировать локальные тома и извлечь и размонтировать все объемы, используйте Дисковый Арбитраж API вместо этого (для получения дополнительной информации, посмотрите Дисковую Арбитражную Ссылку Платформы). Для монтирования сетевого тома использовать NetFSMountURLAsync вместо этого (для отмены незаконченного запроса монтирования использовать NetFSMountURLCancel). Для получения дополнительной информации посмотрите NetFS.h в /System/Library/Frameworks/NetFS.framework/Headers.

Объявление

Objective C

OSStatus FSMountLocalVolumeSync ( CFStringRef diskID, CFURLRef mountDir, FSVolumeRefNum *mountedVolumeRefNum, OptionBits flags );

Параметры

`diskID`	Диск для монтирования.
`mountDir`	Передача в `NULL`; в настоящее время только `NULL` поддерживается.
`mountedVolumeRefNum`	По возврату, указателю на ссылочный номер объема недавно смонтированного объема.
`flags`	Опции для будущего использования.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Эта функция монтирует диск, указанный diskID параметр в расположении, указанном mountDir параметр. Если mountDir NULL, расположение по умолчанию используется. Эта функция возвраты после монтирования завершена.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.2 и позже.

Осуждаемый в OS X v10.8.


    
    FSMountServerVolumeSync
    FSMountServerVolumeSync

(OS X v10.8)

Монтирует объем сервера.

Оператор осуждения

Объявление

Objective C

OSStatus FSMountServerVolumeSync ( CFURLRef url, CFURLRef mountDir, CFStringRef user, CFStringRef password, FSVolumeRefNum *mountedVolumeRefNum, OptionBits flags );

Параметры

`url`	Сервер для монтирования.
`mountDir`	Каталог для монтирования сервера к. Если этот параметр `NULL`, расположение по умолчанию используется.
`user`	Строка для передачи как пользователь для аутентификации.
`password`	Строка для передачи как пароль для аутентифицируемого входит в систему.
`mountedVolumeRefNum`	По возврату, указателю на ссылочный номер объема недавно смонтированного объема.
`flags`	Опции для будущего использования.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Эта функция смонтирует сервер, указанный url параметр в расположении, указанном mountDir параметр. Если mountDir NULL, расположение по умолчанию используется. Дополнительный пользователь и пароль могут быть переданы в для аутентификации. Если никакому пользователю или паролю не будут предоставлены тогда, то базовая файловая система обработает аутентификацию при необходимости. Эта функция возвраты после монтирования завершена.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.2 и позже.

Осуждаемый в OS X v10.8.


    
    FSUnmountVolumeSync
    FSUnmountVolumeSync

(OS X v10.8)

Размонтировал объем.

Оператор осуждения

Объявление

Objective C

OSStatus FSUnmountVolumeSync ( FSVolumeRefNum vRefNum, OptionBits flags, pid_t *dissenter );

Параметры

`vRefNum`	Ссылочный номер объема объема для размонтирования.
`flags`	Опции для будущего использования.
`dissenter`	По возврату, указателю на изодромный с предварением из процесса, отклонившего размонтирование, если отклонено размонтирование.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Эта функция размонтировала объем, указанный vRefNum параметр. Если объем не может быть размонтирован изодромный с предварением из процесса, отклонившего размонтирование, будет возвращен в dissenter параметр. Эта функция возвраты после размонтирования завершена.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.2 и позже.

Осуждаемый в OS X v10.8.


    
    FSEjectVolumeSync
    FSEjectVolumeSync

(OS X v10.8)

Извлекает объем.

Оператор осуждения

Объявление

Objective C

OSStatus FSEjectVolumeSync ( FSVolumeRefNum vRefNum, OptionBits flags, pid_t *dissenter );

Параметры

`vRefNum`	Ссылочный номер объема объема для извлечения.
`flags`	Опции для будущего использования.
`dissenter`	По возврату, указателю на изодромный с предварением из процесса, отклонившего размонтирование, если отклонено извлечение.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Эта функция извлекает объем, указанный vRefNum параметр. Если объем не может быть извлечен изодромный с предварением из процесса, отклонившего размонтирование, будет возвращен в dissenter параметр. Эта функция возвраты после извлечения завершена. Извлечение объема приведет к размонтированию других объемов на том же устройстве.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.2 и позже.

Осуждаемый в OS X v10.8.

FSCreateVolumeOperation FSCreateVolumeOperation (OS X v10.8)

Возвраты FSVolumeOperation который может использоваться для асинхронной работы объема.

Оператор осуждения

Чтобы смонтировать локальные тома и извлечь и размонтировать все объемы, используйте Дисковый Арбитраж API вместо этого (для получения дополнительной информации, посмотрите Дисковую Арбитражную Ссылку Платформы). Для монтирования сетевого тома использовать NetFSMountURLAsync вместо этого (для отмены незаконченного запроса монтирования использовать NetFSMountURLCancel). Для получения дополнительной информации посмотрите NetFS.h в /System/Library/Frameworks/NetFS.framework/Headers.

Объявление

Objective C

OSStatus FSCreateVolumeOperation ( FSVolumeOperation *volumeOp );

Параметры

volumeOp

Новое FSVolumeOperation.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Когда работа завершается FSVolumeOperation должен быть избавлен для освобождения памяти, связанной с использованием работы FSDisposeVolumeOperation.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.2 и позже.
Осуждаемый в OS X v10.8.
FSCancelVolumeOperation FSCancelVolumeOperation (OS X v10.8)

Отменяет выдающуюся асинхронную работу монтирования объема.

Оператор осуждения

Чтобы смонтировать локальные тома и извлечь и размонтировать все объемы, используйте Дисковый Арбитраж API вместо этого (для получения дополнительной информации, посмотрите Дисковую Арбитражную Ссылку Платформы). Для монтирования сетевого тома использовать NetFSMountURLAsync вместо этого (для отмены незаконченного запроса монтирования использовать NetFSMountURLCancel). Для получения дополнительной информации посмотрите NetFS.h в /System/Library/Frameworks/NetFS.framework/Headers.

Объявление

Objective C

OSStatus FSCancelVolumeOperation ( FSVolumeOperation volumeOp );

Параметры

volumeOp

Асинхронная работа объема для отмены.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Специальные замечания

Эта функция в настоящее время только поддерживается для сервера, монтируется.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.2 и позже.
Осуждаемый в OS X v10.8.
FSDisposeVolumeOperation FSDisposeVolumeOperation (OS X v10.8)

Выпускает память, связанную с работой объема.

Оператор осуждения

Чтобы смонтировать локальные тома и извлечь и размонтировать все объемы, используйте Дисковый Арбитраж API вместо этого (для получения дополнительной информации, посмотрите Дисковую Арбитражную Ссылку Платформы). Для монтирования сетевого тома использовать NetFSMountURLAsync вместо этого (для отмены незаконченного запроса монтирования использовать NetFSMountURLCancel). Для получения дополнительной информации посмотрите NetFS.h в /System/Library/Frameworks/NetFS.framework/Headers.

Объявление

Objective C

OSStatus FSDisposeVolumeOperation ( FSVolumeOperation volumeOp );

Параметры

volumeOp

FSVolumeOperation выпускать.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера. Эта функция возвратится paramErr если FSVolumeOperation используется.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.2 и позже.
Осуждаемый в OS X v10.8.


    
    FSMountLocalVolumeAsync
    FSMountLocalVolumeAsync

(OS X v10.8)

Монтирует объем асинхронно.

Оператор осуждения

Объявление

Objective C

OSStatus FSMountLocalVolumeAsync ( CFStringRef diskID, CFURLRef mountDir, FSVolumeOperation volumeOp, void *clientData, OptionBits flags, FSVolumeMountUPP callback, CFRunLoopRef runloop, CFStringRef runloopMode );

Параметры

`diskID`	Диск для монтирования.
`mountDir`	Передача в `NULL` ; в настоящее время только `NULL` поддерживается.
`volumeOp`	`FSVolumeOperation` возвращенный `FSCreateVolumeOperation`
`clientData`	Указатель на клиентские данные связался с работой. Этот параметр может быть `NULL`.
`flags`	Опции для будущего использования.
`callback`	Функция для вызова, когда монтирование завершено. Этот параметр может быть `NULL`.
`runloop`	runloop для работы.
`runloopMode`	Режим для runloop.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Эта функция запускает процесс для монтирования диска, указанного diskID параметр в расположении, указанном mountDir параметр. Если mountDir NULL, расположение по умолчанию используется. Если функция обратного вызова - то, при условии, что функция будет вызвана, когда работа монтирования будет завершена. Как только эта функция возвращается noErr состояние работы может быть найдено с помощью FSGetAsyncMountStatus функция.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.2 и позже.

Осуждаемый в OS X v10.8.


    
    FSMountServerVolumeAsync
    FSMountServerVolumeAsync

(OS X v10.8)

Монтирует объем сервера асинхронно.

Оператор осуждения

Объявление

Objective C

OSStatus FSMountServerVolumeAsync ( CFURLRef url, CFURLRef mountDir, CFStringRef user, CFStringRef password, FSVolumeOperation volumeOp, void *clientData, OptionBits flags, FSVolumeMountUPP callback, CFRunLoopRef runloop, CFStringRef runloopMode );

Параметры

`url`	Сервер для монтирования.
`mountDir`	Каталог для монтирования сервера к. Если этот параметр `NULL`, расположение по умолчанию используется.
`user`	Строка для передачи как пользователь для аутентификации. Этот параметр может быть `NULL`.
`password`	Строка для передачи как пароль для аутентифицируемого входит в систему. Этот параметр может быть `NULL`.
`volumeOp`	`FSVolumeOperation` возвращенный `FSCreateVolumeOperation` функция.
`clientData`	Указатель на клиентские данные связался с работой. Этот параметр может быть `NULL`.
`flags`	Опции для будущего использования.
`callback`	Функция для вызова, когда монтирование завершено. Этот параметр может быть `NULL`.
`runloop`	runloop для работы.
`runloopMode`	Режим для runloop.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Эта функция запустит процесс для монтирования сервера, указанного url параметр в расположении, указанном mountDir параметр. Если mountDir NULL, расположение по умолчанию используется. Дополнительный пользователь и пароль могут быть переданы в для аутентификации. Если никакому пользователю или паролю не будут предоставлены тогда, то базовая файловая система обработает аутентификацию при необходимости. Если функция обратного вызова - то, при условии, что функция будет вызвана, когда работа монтирования будет завершена. Как только эта функция возвращается noErr состояние работы может быть найдено с помощью FSGetAsyncMountStatus функция.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.2 и позже.

Осуждаемый в OS X v10.8.


    
    FSUnmountVolumeAsync
    FSUnmountVolumeAsync

(OS X v10.8)

Размонтировал объем асинхронно.

Оператор осуждения

Объявление

Objective C

OSStatus FSUnmountVolumeAsync ( FSVolumeRefNum vRefNum, OptionBits flags, FSVolumeOperation volumeOp, void *clientData, FSVolumeUnmountUPP callback, CFRunLoopRef runloop, CFStringRef runloopMode );

Параметры

`vRefNum`	Ссылочный номер объема объема для размонтирования.
`flags`	Опции для будущего использования.
`volumeOp`	`FSVolumeOperation` возвращенный `FSCreateVolumeOperation` функция.
`clientData`	Указатель на клиентские данные связался с работой.
`callback`	Функция для вызова, когда размонтирование завершено.
`runloop`	runloop для работы.
`runloopMode`	Режим для runloop.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Эта функция запускает процесс размонтирования объема, указанного vRefNum параметр. Если функция обратного вызова - то, при условии, что функция будет вызвана, когда работа размонтирования будет завершена. Как только эта функция возвращается noErr состояние работы может быть найдено с помощью FSGetAsyncUnmountStatus функция.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.2 и позже.

Осуждаемый в OS X v10.8.


    
    FSEjectVolumeAsync
    FSEjectVolumeAsync

(OS X v10.8)

Асинхронно извлекает объем.

Оператор осуждения

Объявление

Objective C

OSStatus FSEjectVolumeAsync ( FSVolumeRefNum vRefNum, OptionBits flags, FSVolumeOperation volumeOp, void *clientData, FSVolumeEjectUPP callback, CFRunLoopRef runloop, CFStringRef runloopMode );

Параметры

`vRefNum`	Ссылочный номер объема объема для извлечения.
`flags`	Опции для будущего использования.
`volumeOp`	`FSVolumeOperation` возвращенный `FSCreateVolumeOperation`.
`clientData`	Указатель на клиентские данные связался с работой. Этот параметр может быть `NULL`.
`callback`	Функция для вызова, когда извлекаются, завершена.
`runloop`	runloop для работы.
`runloopMode`	Режим для runloop.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Эта функция запускает процесс извлечения объема, указанного vRefNum параметр. Если функция обратного вызова - то, при условии, что функция будет вызвана, когда извлечь работа будет завершена. Как только эта функция возвращается noErr состояние работы может быть найдено с помощью FSGetAsyncEjectStatus.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.2 и позже.

Осуждаемый в OS X v10.8.


    
    FSGetAsyncMountStatus
    FSGetAsyncMountStatus

(OS X v10.8)

Возвращает текущий статус асинхронной работы монтирования.

Оператор осуждения

Объявление

Objective C

OSStatus FSGetAsyncMountStatus ( FSVolumeOperation volumeOp, FSMountStatus *status, OSStatus *volumeOpStatus, FSVolumeRefNum *mountedVolumeRefNum, void **clientData );

Параметры

`volumeOp`	Асинхронная работа объема для получения состояния о.
`status`	По возврату, указателю на состояние работы.
`volumeOpStatus`	Если состояние `kAsyncMountComplete` тогда этот параметр содержит код результата для работы по возврату.
`mountedVolumeRefNum`	Если состояние `kAsyncMountComplete` и `volumeOpStatus` параметр `noErr` тогда это - ссылочный номер объема для недавно смонтированного объема по возврату.
`clientData`	По возврату указатель на клиентские данные связался с оригиналом `FSMountServerVolumeAsync` работа.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Возвращаемое значение noErr показывает что status параметр был заполнен допустимой информацией. Если состояние kAsyncMountComplete тогда остальная часть данных возвратилась, допустимо. Если состояние - что-либо еще тогда volumeOpStatus и mountedVolumeRefNum параметры недопустимы, но clientData параметр допустим.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.2 и позже.

Осуждаемый в OS X v10.8.


    
    FSGetAsyncUnmountStatus
    FSGetAsyncUnmountStatus

(OS X v10.8)

Возвращает текущий статус асинхронной работы размонтирования.

Оператор осуждения

Объявление

Objective C

OSStatus FSGetAsyncUnmountStatus ( FSVolumeOperation volumeOp, FSUnmountStatus *status, OSStatus *volumeOpStatus, FSVolumeRefNum *volumeRefNum, pid_t *dissenter, void **clientData );

Параметры

`volumeOp`	Асинхронная работа объема для получения состояния о.
`status`	По возврату, указателю на состояние работы.
`volumeOpStatus`	Если состояние `kAsyncUnmountComplete` тогда этот параметр содержит указатель на код результата (`OSStatus`) для работы по возврату.
`volumeRefNum`	По возврату, указателю на ссылочный номер объема размонтированного объема.
`dissenter`	По возврату, указателю на изодромный с предварением из процесса, отклонившего размонтирование, если отклонено размонтирование.
`clientData`	По возврату указатель на клиентские данные связался с оригиналом `FSMountServerVolumeAsync` работа.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера. Возвращаемое значение noErr показывает что status параметр был заполнен допустимой информацией.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.2 и позже.

Осуждаемый в OS X v10.8.


    
    FSGetAsyncEjectStatus
    FSGetAsyncEjectStatus

(OS X v10.8)

Возвращается текущий статус асинхронного извлекают работу.

Оператор осуждения

Объявление

Objective C

OSStatus FSGetAsyncEjectStatus ( FSVolumeOperation volumeOp, FSEjectStatus *status, OSStatus *volumeOpStatus, FSVolumeRefNum *volumeRefNum, pid_t *dissenter, void **clientData );

Параметры

`volumeOp`	Асинхронная работа объема для получения состояния о.
`status`	По возврату, указателю на состояние работы.
`volumeOpStatus`	Если `status` параметр `kAsyncEjectComplete` тогда это содержит код результата (`OSStatus`) для работы по возврату.
`volumeRefNum`	По возврату, ссылочному номеру объема извлекаемого объема.
`dissenter`	По возврату, указателю на изодромный с предварением из процесса, отклонившего размонтирование, если отклонено извлечение.
`clientData`	По возврату указатель на клиентские данные связался с оригиналом `FSMountServerVolumeAsync` работа.

Возвращаемое значение

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.2 и позже.

Осуждаемый в OS X v10.8.


    
    UnmountVol
    UnmountVol

(OS X v10.4)

Размонтировал в настоящее время не использующийся объем.

Оператор осуждения

Использовать FSUnmountVolumeSync вместо этого.

Объявление

Objective C

OSErr UnmountVol ( ConstStr63Param volName, FSVolumeRefNum vRefNum );

Параметры

`volName`	Имя смонтированного объема. Этот параметр может быть `NULL`.
`vRefNum`	Ссылочный номер объема, управляйте числом, или 0 для объема по умолчанию.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Все файлы на объеме (кроме открытых Операционной системой) должны быть закрыты перед вызовом UnmountVol, который не извлекает объем.

Большинство приложений не должно использовать эту функцию, потому что пользователь обычно извлекается (и возможно также размонтировался), объем в Средстве поиска.

Специальные замечания

Не размонтируйте объем запуска. Выполнение так вызовет системный катастрофический отказ.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    PBUnmountVol
    PBUnmountVol

(OS X v10.4)

Размонтировал объем.

Оператор осуждения

Использовать FSEjectVolumeSync или FSUnmountVolumeSync вместо этого.

Объявление

Objective C

OSErr PBUnmountVol ( ParmBlkPtr paramBlock );

Параметры


      paramBlock

Указатель на VolumeParam вариант основного блока параметра Файлового менеджера. Посмотрите ParamBlockRec для описания ParamBlockRec тип данных.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioResult`	На выводе, коде результата функции.
`ioNamePtr`	На вводе, указателе на имя объема.
`ioVRefNum`	На вводе, ссылочном номере объема объема для размонтирования, или 0 для объема по умолчанию.

Это вызовы функции PBFlushVolSync сбросить указанный объем, размонтировало и извлекает объем и выпускает память, используемую для объема. До вызывания этой функции должны быть закрыты все пользовательские файлы на объеме. Извлечение объема приводит к размонтированию других объемов на том же устройстве.

PBUnmountVol функция всегда выполняется синхронно.

Специальные замечания

Не размонтируйте объем запуска. Выполнение так вызовет системный катастрофический отказ.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.

Монтирование удаленных объемов

FSGetVolumeMountInfoSize FSGetVolumeMountInfoSize (OS X v10.8)

Определяет размер монтирующейся информации, связанной с указанным объемом.

Оператор осуждения

Используйте NSURL или CFURL отметьте APIs вместо этого; для узнавания больше см. Ссылку класса NSURL и Ссылку CFURL.

Объявление

Objective C

OSStatus FSGetVolumeMountInfoSize ( FSVolumeRefNum volume, ByteCount *size );

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.8.
FSGetVolumeMountInfo FSGetVolumeMountInfo (OS X v10.8)

Получает монтирующуюся информацию, связанную с указанным объемом.

Оператор осуждения

Используйте NSURL или CFURL отметьте APIs вместо этого; для узнавания больше см. Ссылку класса NSURL и Ссылку CFURL.

Объявление

Objective C

OSStatus FSGetVolumeMountInfo ( FSVolumeRefNum volume, BytePtr buffer, ByteCount bufferSize, ByteCount *actualSize );

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.8.
FSVolumeMount FSVolumeMount (OS X v10.8)

Монтирует объем с помощью указанной информации о монтировании.

Оператор осуждения

Используйте NSURL или CFURL отметьте APIs вместо этого; для узнавания больше см. Ссылку класса NSURL и Ссылку CFURL.

Объявление

Objective C

OSStatus FSVolumeMount ( BytePtr buffer, FSVolumeRefNum *mountedVolume );

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.8.


    
    PBGetVolMountInfoSize
    PBGetVolMountInfoSize

(OS X v10.5)

Определяет сколько пространства для выделения для объема, монтирующего информационную структуру.

Оператор осуждения

Использовать FSVolumeMount вместо этого.

Объявление

Objective C

OSErr PBGetVolMountInfoSize ( ParmBlkPtr paramBlock );

Параметры


      paramBlock

Указатель на IOParam вариант основного блока параметра Файлового менеджера. Посмотрите HParamBlockRec для описания HParamBlockRec тип данных.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioNamePtr`	На вводе, указателе на путь
`ioVRefNum`	На вводе, спецификации объема. Это поле может содержать ссылочный номер объема, число диска, или 0 для объема по умолчанию.
`ioBuffer`	На вводе, указателе на хранение для получения информации о размере, имеющей тип `Integer` (2 байта). Если `PBGetVolMountInfoSize` возвраты `noErr`, то целое число содержит размер объема, монтирующего информационную структуру на выводе.

Необходимо вызвать эту функцию перед вызовом PBGetVolMountInfo , получить размер информации о монтировании объема, для которой необходимо выделить хранение. Тогда вызовите PBGetVolMountInfo получать фактическую информацию о монтировании объема.

Специальные замечания

Эта функция выполняется синхронно. Во время прерывания Вы не должны вызывать его.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.5.

Не доступный 64-разрядным приложениям.


    
    PBGetVolMountInfo
    PBGetVolMountInfo

(OS X v10.5)

Получает запись, содержащую всю информацию, должен был смонтировать объем, за исключением паролей.

Оператор осуждения

Использовать FSVolumeMount вместо этого.

Объявление

Objective C

OSErr PBGetVolMountInfo ( ParmBlkPtr paramBlock );

Параметры


      paramBlock

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioNamePtr`	На вводе, указателе на путь
`ioVRefNum`	На вводе, спецификации объема. Это поле может содержать ссылочный номер объема, число диска, или 0 для объема по умолчанию.
`ioBuffer`	На вводе, указателе на буфер для содержания монтирующейся информации. Длина буфера указана значением, на которое указывают `ioBuffer` поле в предыдущем вызове к `PBGetVolMountInfoSize`. На выводе, монтирующейся информации для указанного объема. Можно позже передать эту структуру `PBVolumeMount` функционируйте для монтирования объема. Монтирующаяся информация для объема AppleShare хранится как запись монтирования AFP. `PBGetVolMountInfo` функция не возвращает пароль пользователя или пароль тома в `AFPVolMountInfo` структура. Ваше приложение должно требовать этих паролей от пользователя и заполнить структуру прежде, чем попытаться смонтировать удаленный объем.

Эта функция позволяет Вашему приложению записывать монтирующуюся информацию для объема и затем монтировать объем позже. Эта программируемая функция монтирования хранит монтирующуюся информацию в структуре, вызванной AFPVolMountInfo структура.

Специальные замечания

Эта функция выполняется синхронно. Во время прерывания Вы не должны вызывать его.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.5.

Не доступный 64-разрядным приложениям.


    
    PBVolumeMount
    PBVolumeMount

(OS X v10.5)

Монтирует объем.

Оператор осуждения

Использовать FSVolumeMount вместо этого.

Объявление

Objective C

OSErr PBVolumeMount ( ParmBlkPtr paramBlock );

Параметры


      paramBlock

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:


      ioVRefNum

На выводе, ссылочном номере объема для смонтированного объема.


      ioBuffer

На вводе, указателе на монтирующуюся информацию. Можно использовать информацию о монтировании объема, возвращенную PBGetVolMountInfo функционируйте или можно использовать объем, монтирующий информационную структуру, заполненную приложением. Если Вы монтируете объем AppleShare, помещаете AFP объема, монтирующий информационную структуру в буфере, на который указывают ioBuffer поле.

Эта функция позволяет Вашему приложению записывать монтирующуюся информацию для объема и затем монтировать объем позже.

PBGetVolMountInfo функция не возвращает пароли пользователя и пароли тома, они возвращаются пробел. Как правило, Ваше приложение просит у пользователя любые необходимые пароли и заполняет те поля как раз перед вызовом PBVolumeMount. Если Вы хотите смонтировать объем с гостевым состоянием, передайте пустую строку как пароль пользователя.

Если у Вас есть достаточно информации об объеме, можно заполнить монтирующуюся структуру сами и вызов PBVolumeMount, в то время как объем был смонтирован, даже если Вы не сохраняли монтирующуюся информацию. Для монтирования объема AFP необходимо заполнить структуру с, по крайней мере, именем зоны, именем сервера, именем пользователя, паролем пользователя и паролем тома. Можно разметить поля в любом порядке в поле данных, пока Вы указываете корректные смещения.

В целом проще смонтировать удаленные объемы путем создания и затем разрешения записей псевдонима, описывающих те объемы. Менеджер по Псевдониму выводит на экран стандартный пользовательский интерфейс для аутентификации пользователя при разрешении записей псевдонима для удаленных объемов. В результате эта функция является прежде всего представляющей интерес для приложений, которые должны смонтировать удаленные объемы без пользовательского интерфейса или с некоторым настроенным пользовательским интерфейсом.

Специальные замечания

Объемы AFP в настоящее время игнорируют метод аутентификации пользователей, переданный в uamType поле объема, монтирующего информационную структуру, адрес которой передается в ioBuffer поле блока параметра. Самый безопасный доступный метод используется по умолчанию, кроме тех случаев, когда пользователь монтирует объем как Гость и использует kNoUserAuthentication метод аутентификации.

Эта функция выполняется синхронно. Во время прерывания Вы не должны вызывать его.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.5.

Не доступный 64-разрядным приложениям.

Перемещение, переименовывая или заменяя файлы или каталоги


    
    FSMoveObject
    FSMoveObject

(OS X v10.8)

Перемещает файл или каталог в различный каталог.

Оператор осуждения

Объявление

Objective C

OSErr FSMoveObject ( const FSRef *ref, const FSRef *destDirectory, FSRef *newRef );

Параметры

`ref`	Указатель на `FSRef` указание файла или каталога для перемещения. Посмотрите `FSRef` для описания `FSRef` тип данных.
`destDirectory`	Указатель на `FSRef` указание то, каталога, в который файл или каталог, обозначенный `ref` параметр будет перемещен.
`newRef`	По возврату, указателю на новое `FSRef` для файла или каталога в его новом расположении. Этот параметр является дополнительным; если Вы не желаете `FSRef` возвращенный, передача `NULL`.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера. Если destDirectory параметр указывает несуществующий объект, dirNFErr возвращается; если это относится к файлу, errFSNotAFolder возвращается. Если каталог, указанный в destDirectory параметр находится на различном объеме, чем файл или каталог, обозначенный в ref параметр, diffVolErr возвращается.

Обсуждение

Перемещение объекта может изменить FSRef. Если Вы хотите продолжать обращаться к объекту, необходимо передать не - NULL указатель в newRef параметр и использование FSRef возвращенный там для обращения к объекту после перемещения. Оригинал FSRef переданный в ref параметр может или может не быть применимым после перемещения. newRef параметр может указать на то же хранение как destDirectory или ref параметры.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    PBMoveObjectSync
    PBMoveObjectSync

(OS X v10.8)

Перемещает файл или каталог в различный каталог.

Оператор осуждения

Объявление

Objective C

OSErr PBMoveObjectSync ( FSRefParam *paramBlock );

Параметры


      paramBlock

Указатель на блок параметра ссылки файловой системы. Посмотрите FSRefParam для описания FSRefParam тип данных.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера. Если parentRef поле блока параметра указывает несуществующий объект, dirNFErr возвращается; если это относится к файлу, errFSNotAFolder возвращается. Если каталог, указанный в parentRef поле находится на различном объеме, чем файл или каталог, обозначенный в ref поле, diffVolErr возвращается.

Обсуждение

Соответствующие поля блока параметра:

`ioResult`	На выводе, коде результата функции. Если `parentRef` поле указывает несуществующий объект, `dirNFErr` возвращается; если это относится к файлу, то `errFSNotAFolder` возвращается. Если каталог, указанный в `parentRef` находится на различном объеме, чем файл или каталог, обозначенный `ref` поле, `diffVolErr` возвращается.
`ref`	На вводе, указателе на `FSRef` указание файла или каталога для перемещения.
`parentRef`	На вводе, указателе на `FSRef` указание то, каталога, в который файл или каталог, поданный `ref` поле будет перемещено.
`newRef`	На выводе, указателе на новое `FSRef` для файла или каталога в его новом расположении. Это поле является дополнительным; если Вы не желаете `FSRef` возвращенный, передача `NULL` здесь.

Перемещение объекта может изменить FSRef. Если Вы хотите продолжать обращаться к объекту, необходимо передать не - NULL указатель в newRef поле и использование FSRef возвращенный там для обращения к объекту после перемещения. Оригинал FSRef переданный в ref поле может или может не быть применимым после перемещения. newRef поле может указать на то же хранение как parentRef или ref поля.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    PBMoveObjectAsync
    PBMoveObjectAsync

(OS X v10.8)

Перемещает файл или каталог в различный каталог.

Оператор осуждения

Объявление

Objective C

void PBMoveObjectAsync ( FSRefParam *paramBlock );

Параметры


      paramBlock

Указатель на блок параметра ссылки файловой системы. Посмотрите FSRefParam для описания FSRefParam тип данных.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции. Если `parentRef` поле указывает несуществующий объект, `dirNFErr` возвращается; если это относится к файлу, то `errFSNotAFolder` возвращается. Если каталог, указанный в `parentRef` находится на различном объеме, чем файл или каталог, обозначенный `ref` поле, `diffVolErr` возвращается.
`ref`	На вводе, указателе на `FSRef` указание файла или каталога для перемещения.
`parentRef`	На вводе, указателе на `FSRef` указание то, каталога, в который файл или каталог, поданный `ref` поле будет перемещено.
`newRef`	На выводе, указателе на новое `FSRef` для файла или каталога в его новом расположении. Это поле является дополнительным; если Вы не желаете `FSRef` возвращенный, передача `NULL` здесь.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    FSRenameUnicode
    FSRenameUnicode

(OS X v10.8)

Переименовывает файл или папку.

Оператор осуждения

Объявление

Objective C

OSErr FSRenameUnicode ( const FSRef *ref, UniCharCount nameLength, const UniChar *name, TextEncoding textEncodingHint, FSRef *newRef );

Параметры

`ref`	Указатель на `FSRef` для файла или каталога для переименования. Посмотрите `FSRef` для описания `FSRef` тип данных.
`nameLength`	Длина нового имени в символах Unicode.
`name`	Указатель на новое имя Unicode файла или каталога.
`textEncodingHint`	Предложенное текстовое кодирование для использования при преобразовании имени Unicode файла или каталога к некоторому другому кодированию. Если Вы передаете константу `kTextEncodingUnknown`, Файловый менеджер будет использовать значение по умолчанию.
`newRef`	По возврату, указателю на новое `FSRef` для файла или каталога. Этот параметр является дополнительным; если Вы не желаете `FSRef` возвращенный, передача `NULL`.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Поскольку переименование объекта может изменить FSRef, необходимо передать не - NULL указатель в newRef параметр и использование FSRef возвращенный там для доступа к объекту после переименования, если Вы хотите продолжать обращаться к объекту. FSRef переданный в ref параметр может или может не быть применимым после того, как будет переименован объект. FSRef возвращенный в newRef параметр может указать на то же хранение как FSRef переданный в ref.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    PBRenameUnicodeSync
    PBRenameUnicodeSync

(OS X v10.8)

Переименовывает файл или папку.

Оператор осуждения

Объявление

Objective C

OSErr PBRenameUnicodeSync ( FSRefParam *paramBlock );

Параметры


      paramBlock

Указатель на блок параметра ссылки файловой системы. Посмотрите FSRefParam для описания FSRefParam тип данных.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ref`	На вводе, указателе на `FSRef` для файла или каталога для переименования.
`nameLength`	На вводе, длине нового имени в символах Unicode.
`name`	На вводе, указателе на новое имя Unicode файла или каталога.
`textEncodingHint`	На вводе, предложенном текстовом кодировании для использования при преобразовании имени Unicode файла или каталога к некоторому другому кодированию. Если Вы передаете константу `kTextEncodingUnknown`, Файловый менеджер будет использовать значение по умолчанию.
`newRef`	На выводе, указатель на новое `FSRef` для файла или каталога. Это поле является дополнительным; если Вы не желаете `FSRef` возвращенный, передача `NULL`.

Поскольку переименование объекта может изменить FSRef, необходимо передать не - NULL указатель в newRef поле и использование FSRef возвращенный там для доступа к объекту после переименования, если Вы хотите продолжать обращаться к объекту. FSRef переданный в ref поле может или может не быть применимым после того, как будет переименован объект. FSRef возвращенный в newRef поле может указать на то же хранение как FSRef переданный в ref.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    PBRenameUnicodeAsync
    PBRenameUnicodeAsync

(OS X v10.8)

Переименовывает файл или папку.

Оператор осуждения

Объявление

Objective C

void PBRenameUnicodeAsync ( FSRefParam *paramBlock );

Параметры


      paramBlock

Указатель на блок параметра ссылки файловой системы. Посмотрите FSRefParam для описания FSRefParam тип данных.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции.
`ref`	На вводе, указателе на `FSRef` для файла или каталога для переименования.
`nameLength`	На вводе, длине нового имени в символах Unicode.
`name`	На вводе, указателе на новое имя Unicode файла или каталога.
`textEncodingHint`	На вводе, предложенном текстовом кодировании для использования при преобразовании имени Unicode файла или каталога к некоторому другому кодированию. Если Вы передаете константу `kTextEncodingUnknown`, Файловый менеджер будет использовать значение по умолчанию.
`newRef`	На выводе, указатель на новое `FSRef` для файла или каталога. Это поле является дополнительным; если Вы не желаете `FSRef` возвращенный, передача `NULL`.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    FSpCatMove
    FSpCatMove

(OS X v10.4)

Перемещает файл или каталог от одного расположения до другого на том же объеме.

Оператор осуждения

Использовать FSMoveObject вместо этого.

Объявление

Objective C

OSErr FSpCatMove ( const FSSpec *source, const FSSpec *dest );

Параметры


      source

Указатель на FSSpec структура, указывающая название и местоположение файла или каталога для перемещения. Посмотрите FSSpec для описания FSSpec тип данных.


      dest

Указатель на FSSpec структура, указывающая название и местоположение каталога, в который должны быть перемещены исходный файл или каталог. Каталог ID, указанный в parID поле этого FSSpec каталог ID родителя каталога, в который Вы хотите переместить исходный файл или каталог. name поле этого FSSpec указывает имя каталога, в который Вы хотите переместить исходный файл или каталог.

Если Вы уже не знаете родительский каталог ID целевого каталога, могло бы быть проще использовать PBCatMoveSync или PBCatMoveAsync функция, которые позволяют Вам указывать только каталог ID целевого каталога.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

FSpCatMove функция является строго работой каталога файла; это фактически не изменяет местоположение файла или каталога на диске. Вы не можете использовать FSpCatMove перемещать файл или каталог в другой объем (т.е. vRefNum поле в обоих FSSpec структуры в source и dest параметры должны быть тем же). Кроме того, Вы не можете использовать FSpCatMove переименовать файлы или каталоги; для переименования файла или каталога использовать FSpRename.

Если необходимо переместить файлы или каталоги с именованными ветвлениями кроме ветвей данных и ветвей ресурсов с длинными именами Unicode или файлами, больше, чем 2 ГБ, необходимо использовать FSMoveObject функция или один из соответствующего параметра блокирует вызовы, PBMoveObjectSync и PBMoveObjectAsync.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    CatMove
    CatMove

(OS X v10.4)

Файлы или каталоги перемещений от одного каталога до другого на том же объеме.

Оператор осуждения

Использовать FSMoveObject вместо этого.

Объявление

Objective C

OSErr CatMove ( FSVolumeRefNum vRefNum, SInt32 dirID, ConstStr255Param oldName, SInt32 newDirID, ConstStr255Param newName );

Параметры

`vRefNum`	Ссылочный номер объема, управляйте числом, или 0 для объема по умолчанию.
`dirID`	Родительский каталог ID файла или каталога для перемещения.
`oldName`	Существующее имя файла или каталога для перемещения.
`newDirID`	Если `newName` параметр пуст, каталог ID целевого каталога; иначе, родительский каталог ID целевого каталога.
`newName`	Имя целевого каталога. Если допустимое имя каталога предоставлено в этом параметре, родительский каталог целевого каталога указан в `newDirID` параметр. Однако можно указать пустое название для `newName`, когда `newDirID` должен быть установлен в каталог ID целевого каталога. Является обычно самым простым указать целевой каталог путем передачи его каталога ID в `newDirID` параметр и путем установки `newName` к пустому названию. Для указания пустого названия установить `newName` к `':'`.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера. Эта функция возвраты permErr если обращено заблокированный файл.

Обсуждение

CatMove строго работа каталога файла; это фактически не изменяет местоположение файла или каталога на диске.

CatMove функция не может переместить файл или каталог в другой объем (т.е. vRefNum параметр используется в указании и источник и место назначения). Кроме того, Вы не можете использовать его для переименования файлов или каталогов; для переименования файла или каталога использовать HRename.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    PBCatMoveSync
    PBCatMoveSync

(OS X v10.4)

Файлы или каталоги перемещений от одного каталога до другого на том же объеме.

Оператор осуждения

Использовать PBMoveObjectSync вместо этого.

Объявление

Objective C

OSErr PBCatMoveSync ( CMovePBPtr paramBlock );

Параметры


      paramBlock

Указатель на каталог перемещает блок параметра. Посмотрите CMovePBRec для описания CMovePBRec тип данных.

Возвращаемое значение

Обсуждение

Соответствующие поля блока параметра:

`ioNamePtr`	На вводе, указателе на имя файла или каталога для перемещения.
`ioVRefNum`	На вводе, ссылочном номере объема, числе диска, или 0 для объема по умолчанию.
`ioNewName`	На вводе, указателе на имя целевого каталога. Передача `NULL` в этом поле, если Вы хотите указать целевой каталог его каталогом ID.
`ioNewDirID`	На вводе, если `ioNewName` поле `NULL`, каталог ID целевого каталога. Если `ioNewName` не `NULL`, это - родительский каталог ID целевого каталога. Является обычно самым простым указать целевой каталог путем передачи его каталога ID в `ioNewDirID` поле и путем установки `ioNewName` к `NULL`.
`ioDirID`	На вводе, родительский каталог ID файла или каталога для перемещения.

PBCatMoveSync строго работа каталога файла; это фактически не изменяет местоположение файла или каталога на диске. Если ссылка идентификатора файла существует для файла, ссылка идентификатора файла остается с перемещенным файлом.

PBCatMoveSync функция не может переместить файл или каталог в другой объем (т.е. значение в ioVRefNum поле используется в указании и источник и место назначения). Кроме того, Вы не можете использовать его для переименования файлов или каталогов; для переименования файла или каталога использовать FSpRename , PBHRenameSync , или PBHRenameAsync.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    PBCatMoveAsync
    PBCatMoveAsync

(OS X v10.4)

Файлы или каталоги перемещений от одного каталога до другого на том же объеме.

Оператор осуждения

Использовать PBMoveObjectAsync вместо этого.

Объявление

Objective C

OSErr PBCatMoveAsync ( CMovePBPtr paramBlock );

Параметры


      paramBlock

Указатель на каталог перемещает блок параметра. Посмотрите CMovePBRec для описания CMovePBRec тип данных.

Возвращаемое значение

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на функцию завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции.
`ioNamePtr`	На вводе, указателе на имя файла или каталога для перемещения.
`ioVRefNum`	На вводе, ссылочном номере объема, числе диска, или 0 для объема по умолчанию.
`ioNewName`	На вводе, указателе на имя целевого каталога. Передача `NULL` в этом поле, если Вы хотите указать целевой каталог его каталогом ID.
`ioNewDirID`	На вводе, если `ioNewName` поле `NULL`, каталог ID целевого каталога. Если `ioNewName` не `NULL`, это - родительский каталог ID каталога, в который должен быть перемещен файл или каталог. Является обычно самым простым указать целевой каталог путем передачи его каталога ID в `ioNewDirID` поле и путем установки `ioNewName` к `NULL`.
`ioDirID`	На вводе, родительский каталог ID файла или каталога для перемещения.

PBCatMoveAsync строго работа каталога файла; это фактически не изменяет местоположение файла или каталога на диске. Если ссылка идентификатора файла существует для файла, ссылка идентификатора файла остается с перемещенным файлом.

PBCatMoveAsync функция не может переместить файл или каталог в другой объем (т.е. значение в ioVRefNum поле используется в указании и источник и место назначения). Кроме того, Вы не можете использовать его для переименования файлов или каталогов; для переименования файла или каталога использовать FSpRename , PBHRenameSync , или PBHRenameAsync .

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    FSpRename
    FSpRename

(OS X v10.4)

Переименовывает файл или каталог.

Оператор осуждения

Использовать FSRenameUnicode вместо этого.

Объявление

Objective C

OSErr FSpRename ( const FSSpec *spec, ConstStr255Param newName );

Параметры

`spec`	Указатель на `FSSpec` структура, указывающая файл или каталог для переименования. Посмотрите `FSSpec` для описания `FSSpec` тип данных.
`newName`	Новое имя файла или каталога.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Если ссылка идентификатора файла для указанного файла существует, это остается с переименованным файлом.

Если Вы хотите изменить имя новой копии существующего файла, необходимо использовать FSpExchangeFiles функция вместо этого. Для переименования файла или каталога с помощью длинного имени Unicode используйте FSRenameUnicode функционируйте или один из соответствующих блочных вызовов параметра, PBRenameUnicodeSync и PBRenameUnicodeAsync.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    HRename
    HRename

(OS X v10.4)

Переименовывает файл, каталог или объем.

Оператор осуждения

Использовать FSRenameUnicode вместо этого.

Объявление

Objective C

OSErr HRename ( FSVolumeRefNum vRefNum, SInt32 dirID, ConstStr255Param oldName, ConstStr255Param newName );

Параметры

`vRefNum`	Ссылочный номер объема, управляйте числом, или 0 для объема по умолчанию.
`dirID`	Каталог ID.
`oldName`	Существующее имя файла, имя каталога или имя тома.
`newName`	Новое имя файла, имя каталога или имя тома.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Учитывая имя файла или каталога в oldName параметр, HRename изменения это к имени в newName параметр. Поданный имя тома oldName параметр или ссылочный номер объема в vRefNum параметр, HRename изменяет имя объема к имени в newName. Использующиеся в настоящее время пути доступа не затронуты этой функцией.

Если ссылка идентификатора файла существует для файла, Вы переименовываете, идентификатор файла остается с переименованным файлом.

Для переименования файла или каталога с помощью длинного имени Unicode используйте FSRenameUnicode функционируйте или один из соответствующих блочных вызовов параметра, PBRenameUnicodeSync и PBRenameUnicodeAsync.

Специальные замечания

Вы не можете использовать HRename изменить каталог, в котором находится файл. Для перемещения файла или каталога используйте FSpCatMove, PBCatMoveSync, или PBCatMoveAsync функции.

При переименовании объема удостоверьтесь, что оба имени заканчиваются двоеточием.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    PBHRenameSync
    PBHRenameSync

(OS X v10.4)

Переименовывает файл, каталог или объем.

Оператор осуждения

Использовать PBRenameUnicodeSync вместо этого.

Объявление

Objective C

OSErr PBHRenameSync ( HParmBlkPtr paramBlock );

Параметры


      paramBlock

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioNamePtr`	На вводе, указателе на существующее имя файла, имя каталога или имя тома.
`ioVRefNum`	На вводе, ссылочном номере объема, числе диска, или 0 для объема по умолчанию.
`ioMisc`	На вводе, указателе на новое имя для файла, каталога или объема.
`ioDirID`	На вводе, родительский каталог ID файла или каталога для переименования.
`ioFVersNum`	На вводе это поле должно быть инициализировано для обнуления; если это поле не будет нулем, то вызов провалится к теперь устаревшему коду Macintosh File System (MFS), если объем получил доступ, объем MFS.

Данный подсказка к имени файла или каталога в ioNamePtr поле, PBHRenameSync изменения это к имени указало в ioMisc поле. Данный подсказка к имени тома в ioNamePtr или ссылочный номер объема в ioVRefNum, функция изменяет имя объема к имени, указал в ioMisc.

Если ссылка идентификатора файла существует для переименовываемого файла, идентификатор файла остается с файлом.

Специальные замечания

Вы не можете использовать PBHRenameSync изменить каталог, в котором расположен файл. Для перемещения файла или каталога используйте FSpCatMove, PBCatMoveSync, или PBCatMoveAsync функции.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    PBHRenameAsync
    PBHRenameAsync

(OS X v10.4)

Переименовывает файл, каталог или объем.

Оператор осуждения

Использовать PBRenameUnicodeAsync вместо этого.

Объявление

Objective C

OSErr PBHRenameAsync ( HParmBlkPtr paramBlock );

Параметры


      paramBlock

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции.
`ioNamePtr`	На вводе, указателе на существующее имя файла, имя каталога или имя тома.
`ioVRefNum`	На вводе, ссылочном номере объема, числе диска, или 0 для объема по умолчанию.
`ioMisc`	На вводе, указателе на новое имя для файла, каталога или объема.
`ioDirID`	На вводе, родительский каталог ID файла или каталога для переименования.
`ioFVersNum`	На вводе это поле должно быть инициализировано для обнуления; если это поле не будет нулем, то вызов провалится к теперь устаревшему коду Macintosh File System (MFS), если объем получил доступ, объем MFS.

Данный подсказка к имени файла или каталога в ioNamePtr поле, PBHRenameAsync изменения это к имени указало в ioMisc поле. Данный подсказка к имени тома в ioNamePtr или ссылочный номер объема в ioVRefNum, функция изменяет имя объема к имени, указал в ioMisc.

Специальные замечания

Вы не можете использовать PBHRenameAsync изменить каталог, в котором расположен файл. Для перемещения файла или каталога используйте FSpCatMove, PBCatMoveSync, или PBCatMoveAsync функции.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    FSReplaceObject
    FSReplaceObject

(OS X v10.8)

Заменяет исходный объект заменяющим объектом, в родительском каталоге исходного объекта.

Оператор осуждения

Использовать replaceItemAtURL:withItemAtURL:backupItemName:options:resultingItemURL:error: вместо этого.

Объявление

Objective C

OSStatus FSReplaceObject ( const FSRef *originalObject, const FSRef *replacementObject, CFStringRef newName, CFStringRef temporaryName, const FSRef *temporaryDirectory, OptionBits flags, FSRef *resultObject );

Параметры

`originalObject`	Объект, который будет заменен.
`replacementObject`	Объект, которым можно заменить исходный объект.
`newName`	Новое имя для объекта результата.
`temporaryName`	Имя временного объекта (если работа требует одного).
`temporaryDirectory`	Расположение временного объекта (если это необходимо).
`flags`	Ряд опций, указывающих поведение не по умолчанию.
`resultObject`	`FSRef` это относится к объекту результата.

Возвращаемое значение

Возвраты FSRef для объекта результата.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.5 и позже.

Осуждаемый в OS X v10.8.


    
    FSPathReplaceObject
    FSPathReplaceObject

(OS X v10.8)

Заменяет исходный объект заменяющим объектом, в родительском каталоге исходного объекта.

Оператор осуждения

Использовать replaceItemAtURL:withItemAtURL:backupItemName:options:resultingItemURL:error: вместо этого.

Объявление

Objective C

OSStatus FSPathReplaceObject ( const char *originalObjectPath, const char *replacementObjectPath, CFStringRef newName, CFStringRef temporaryName, const char *temporaryDirectoryPath, OptionBits flags );

Параметры

`originalObjectPath`	Путь объекта, который будет заменен.
`replacementObjectPath`	Путь объекта, которым можно заменить исходный объект.
`newName`	Новое имя для объекта результата.
`temporaryName`	Имя временного объекта (если работа требует одного).
`temporaryDirectoryPath`	Путь к каталогу временного объекта (если это необходимо).
`flags`	Ряд опций, указывающих поведение не по умолчанию.
`resultObject`	`FSRef` это относится к объекту результата.

Возвращаемое значение

Возвраты FSRef для объекта результата.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.5 и позже.

Осуждаемый в OS X v10.8.


    
    FSGetTemporaryDirectoryForReplaceObject
    FSGetTemporaryDirectoryForReplaceObject

(OS X v10.8)

Получает предпочтительный каталог для использования в качестве временного каталога.

Оператор осуждения

Использовать replaceItemAtURL:withItemAtURL:backupItemName:options:resultingItemURL:error: вместо этого.

Объявление

Objective C

OSStatus FSGetTemporaryDirectoryForReplaceObject ( const FSRef *originalObject, FSRef *temporaryDirectory, OptionBits flags );

Параметры

`originalObject`	Объект, который будет заменен.
`temporaryDirectory`	Предпочтительный временный каталог.
`flags`	Ряд опций, указывающих поведение не по умолчанию.

Возвращаемое значение

Возвращает надлежащий временный каталог.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.5 и позже.

Осуждаемый в OS X v10.8.


    
    FSPathGetTemporaryDirectoryForReplaceObject
    FSPathGetTemporaryDirectoryForReplaceObject

(OS X v10.8)

Получает путь к предпочтительному каталогу для использования в качестве временного каталога.

Объявление

Objective C

OSStatus FSPathGetTemporaryDirectoryForReplaceObject ( const char *originalObjectPath, char *temporaryDirectoryPath, UInt32 maxPathSize, OptionBits flags );

Параметры

`originalObjectPath`	Путь к объекту, который будет заменен.
`temporaryDirectoryPath`	Путь к предпочтительному временному каталогу.
`maxPathSize`	Размер буфера, которым указывают `temporaryDirectoryPath`.
`flags`	Ряд опций, указывающих поведение не по умолчанию.

Возвращаемое значение

Возвращает путь к надлежащему временному каталогу.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.5 и позже.

Осуждаемый в OS X v10.8.

Получение информации о файле и каталоге Используя итератор каталога на HFS плюс объемы


    
    FSGetCatalogInfoBulk
    FSGetCatalogInfoBulk

(OS X v10.8)

Информация о возвратах об одном или более объектах от итератора каталога. Эта функция может возвратить информацию о многократных объектах в единственном вызове.

Оператор осуждения

Использовать NSDirectoryEnumerator или CFURLEnumerator APIs вместо этого. Для получения дополнительной информации посмотрите Ссылку класса NSDirectoryEnumerator и Ссылку CFURLEnumerator.

Объявление

Objective C

OSErr FSGetCatalogInfoBulk ( FSIterator iterator, ItemCount maximumObjects, ItemCount *actualObjects, Boolean *containerChanged, FSCatalogInfoBitmap whichInfo, FSCatalogInfo *catalogInfos, FSRef *refs, FSSpecPtr specs, HFSUniStr255 *names );

Параметры

`iterator`	Итератор для использования. Можно получить итератор каталога с функцией `FSOpenIterator`, или с одним из связанного параметра блокируют вызовы, `PBOpenIteratorSync` и `PBOpenIteratorAsync`. В настоящее время итератор должен быть создан с `kFSIterateFlat` опция. Посмотрите `FSIterator` для описания `FSIterator` тип данных.
`maximumObjects`	Максимальное количество элементов для возврата для этого вызова.
`actualObjects`	По возврату указатель на фактическое число элементов найден для этого вызова.
`containerChanged`	По возврату, указателю на значение, указывающее, изменилось ли содержание контейнера начиная с предыдущего `FSGetCatalogInfoBulk` вызвать. Если `true`, содержание изменилось. Объекты могут все еще быть возвращены, даже при том, что изменился контейнер. Если так, обратите внимание на то, что, если контейнер изменился, то общий набор элементов возвратился, может быть неправильным: некоторые элементы могут быть возвращены многократно, и некоторые элементы не могут быть возвращены вообще. Если Вы не хотите эту возвращенную информацию, передача a, этот параметр является дополнительным `NULL` указатель. В версии 10.2 OS X и позже, этот параметр всегда устанавливается на `false`. Узнать, изменился ли контейнер начиная с последней возможности на `FSGetCatalogInfoBulk`, проверьте дату модификации контейнера.
`whichInfo`	Битовый массив, указывающий поля информации о каталоге для возврата для каждого элемента. Если Вам не жаль, что любая информация о каталоге не возвратилась, передайте константу `kFSCatInfoNone` в этом параметре. Для описания битов в этом параметре посмотрите Растровые Константы информации о Каталоге.
`catalogInfos`	Указатель на массив информационных структур каталога; один для каждого возвращенного элемента. На вводе, `catalogInfos` параметр должен указать на массив `maximumObjects` информационные структуры каталога. Этот параметр является дополнительным; если Вам не жаль, что любая информация о каталоге не возвратилась, передача `NULL` здесь.
`refs`	Указатель на массив `FSRef` структуры; один для каждого возвращенного элемента. На вводе этот параметр должен для указания на массив `maximumObjectsFSRef` структуры. Этот параметр является дополнительным; если Вы не желаете никому `FSRef` структуры возвратились, передача `NULL` здесь.
`specs`	Указатель на массив `FSSpec` структуры; один для каждого возвращенного элемента. На вводе этот параметр должен для указания на массив `maximumObjectsFSSpec` структуры. Этот параметр является дополнительным; если Вы не желаете никому `FSSpec` структуры возвратились, передача `NULL` здесь.
`names`	Указатель на массив имен; один для каждого возвращенного элемента. Если Вы хотите имя Unicode для каждого найденного элемента, устанавливаете этот параметр для указания на массив `maximumObjectsHFSUniStr255` структуры. Иначе, установите его в `NULL`.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера. Когда все объекты итератора будут возвращены, вызов возвратится errFSNoMoreItems.

Обсуждение

FSGetCatalogInfoBulk вызов может завершиться и возвратиться noErr с меньше, чем maximumObjects элементы возвратились. Это может быть вследствие различных причин, связанных с внутренней реализацией. В этом случае можно продолжать делать FSGetCatalogInfoBulk вызовы с помощью того же итератора.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    PBGetCatalogInfoBulkSync
    PBGetCatalogInfoBulkSync

(OS X v10.8)

Оператор осуждения

Объявление

Objective C

OSErr PBGetCatalogInfoBulkSync ( FSCatalogBulkParam *paramBlock );

Параметры


      paramBlock

Указатель на блок параметра информации о каталоге. Посмотрите FSCatalogBulkParam для описания FSCatalogBulkParam тип данных.

Возвращаемое значение

Обсуждение

Соответствующие поля блока параметра:

`iterator`	На вводе, итератор для использования. Можно получить итератор каталога с функцией `FSOpenIterator` , или с одним из связанного параметра блокируют вызовы, `PBOpenIteratorSync` и `PBOpenIteratorAsync`. В настоящее время итератор должен быть создан с `kFSIterateFlat` опция. Посмотрите `FSIterator` для описания `FSIterator` тип данных.
`maximumItems`	На вводе, максимальном количестве элементов для возврата для этого вызова.
`actualItems`	На выводе фактическое число элементов найдено для этого вызова.
`containerChanged`	На выводе, значение, указывающее, изменилось ли содержание контейнера начиная с предыдущего `PBGetCatalogInfoBulkSync` вызвать. Если `true`, содержание изменилось. Объекты могут все еще быть возвращены, даже при том, что изменился контейнер. Если так, обратите внимание на то, что, если контейнер изменился, то общий набор элементов возвратился, может быть неправильным: некоторые элементы могут быть возвращены многократно, и некоторые элементы не могут быть возвращены вообще.
`whichInfo`	На вводе, битовый массив, указывающий поля информации о каталоге для возврата для каждого элемента. Если Вам не жаль, что любая информация о каталоге не возвратилась, передайте константу `kFSCatInfoNone` в этом поле. Для описания битов в этом поле посмотрите Растровые Константы информации о Каталоге.
`catalogInfo`	На выводе, указателе на массив информационных структур каталога; один для каждого возвращенного элемента. На вводе, `catalogInfo` поле должно указать на массив `maximumItems` информационные структуры каталога. Это поле является дополнительным; если Вам не жаль, что любая информация о каталоге не возвратилась, передача `NULL` здесь. Посмотрите `FSCatalogInfo` для описания `FSCatalogInfo` тип данных.
`refs`	На вводе, указателе на массив `maximumItems` `HFSUniStr255` структуры. На выводе, `FSRef` заполнено для каждого возвращенного элемента. Это поле является дополнительным; если Вы не желаете никому `FSRef` структуры возвратились, передача `NULL` здесь.
`names`	На выводе, указателе на массив имен; один для каждого возвращенного элемента. Если Вы хотите имя Unicode для каждого найденного элемента, устанавливаете это поле для указания на массив `maximumItems` `HFSUniStr255` структуры. Иначе, установите его в `NULL`.
`specs`	На вводе, указателе на массив `maximumItems` `FSSpec` структуры. На выводе, `FSSpec` структура заполнена для каждого возвращенного элемента. Это поле является дополнительным; если Вы не желаете никому `FSSpec` структуры возвратились, передача `NULL` здесь.

PBGetCatalogInfoBulkSync вызов может завершиться и возвратиться noErr с меньше, чем maximumItems элементы возвратились. Это может быть вследствие различных причин, связанных с внутренней реализацией. В этом случае можно продолжать делать PBGetCatalogInfoBulkSync вызовы с помощью того же итератора.

Прежде, чем вызвать эту функцию, необходимо определить, доступно ли это путем вызова Gestalt функция.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    PBGetCatalogInfoBulkAsync
    PBGetCatalogInfoBulkAsync

(OS X v10.8)

Оператор осуждения

Объявление

Objective C

void PBGetCatalogInfoBulkAsync ( FSCatalogBulkParam *paramBlock );

Параметры


      paramBlock

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции. Когда все объекты итератора будут возвращены, вызов возвратится `errFSNoMoreItems`.
`iterator`	На вводе, итератор для использования. Можно получить итератор каталога с функцией `FSOpenIterator` , или с одним из связанного параметра блокируют вызовы, `PBOpenIteratorSync` и `PBOpenIteratorAsync`. В настоящее время итератор должен быть создан с `kFSIterateFlat` опция. Посмотрите `FSIterator` для описания `FSIterator` тип данных.
`maximumItems`	На вводе, максимальном количестве элементов для возврата для этого вызова.
`actualItems`	На выводе фактическое число элементов найдено для этого вызова.
`containerChanged`	На выводе, значение, указывающее, изменилось ли содержание контейнера начиная с предыдущего `PBGetCatalogInfoBulkAsync` вызвать. Если `true`, содержание изменилось. Объекты могут все еще быть возвращены, даже при том, что изменился контейнер. Если так, обратите внимание на то, что, если контейнер изменился, то общий набор элементов возвратился, может быть неправильным: некоторые элементы могут быть возвращены многократно, и некоторые элементы не могут быть возвращены вообще.
`whichInfo`	На вводе, битовый массив, указывающий поля информации о каталоге для возврата для каждого элемента. Если Вам не жаль, что любая информация о каталоге не возвратилась, передайте константу `kFSCatInfoNone` в этом поле. Для описания битов в этом поле посмотрите Растровые Константы информации о Каталоге.
`catalogInfo`	На выводе, указателе на массив информационных структур каталога; один для каждого возвращенного элемента. На вводе, `catalogInfo` поле должно указать на массив `maximumItems` информационные структуры каталога. Это поле является дополнительным; если Вам не жаль, что любая информация о каталоге не возвратилась, передача `NULL` здесь. Посмотрите `FSCatalogInfo` для описания `FSCatalogInfo` тип данных.
`refs`	На вводе, указателе на массив `maximumItems` `FSRef` структуры. На выводе, `FSRef` заполнено для каждого возвращенного элемента. Это поле является дополнительным; если Вы не желаете никому `FSRef` структуры возвратились, передача `NULL` здесь.
`names`	На выводе, указателе на массив имен; один для каждого возвращенного элемента. Если Вы хотите имя Unicode для каждого найденного элемента, устанавливаете это поле для указания на массив `maximumItems` `HFSUniStr255` структуры. Иначе, установите его в `NULL`.
`specs`	На вводе, указателе на массив `maximumItems` `FSSpec` структуры. На выводе, `FSSpec` структура заполнена для каждого возвращенного элемента. Это поле является дополнительным; если Вы не желаете никому `FSSpec` структуры возвратились, передача `NULL` здесь.

PBGetCatalogInfoBulkAsync вызов может завершиться и возвратиться noErr с меньше, чем maximumItems элементы возвратились. Это может быть вследствие различных причин, связанных с внутренней реализацией. В этом случае можно продолжать делать PBGetCatalogInfoBulkSync вызовы с помощью того же итератора.

Прежде, чем вызвать эту функцию, необходимо определить, доступно ли это путем вызова Gestalt функция.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.

Получение информации о блоке управления файлом


    
    PBGetFCBInfoSync
    PBGetFCBInfoSync

(OS X v10.4)

Получает информацию об открытом файле от блока управления файлом.

Оператор осуждения

Использовать PBGetForkCBInfoSync вместо этого.

Объявление

Objective C

OSErr PBGetFCBInfoSync ( FCBPBPtr paramBlock );

Параметры


      paramBlock

Указатель на блок параметра блока управления файлом. Посмотрите FCBPBRec для описания FCBPBRec тип данных.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioNamePtr`	На вводе, указателе на путь. Необходимо передать указатель на a `Str31` оцените, если Вы хотите имя возвращенного файла. Если Вы передаете `NULL`, никакое имя файла не возвращается. На выводе, если `PBGetFCBInfoSync` выполняется успешно, указатель на имя указанного открытого файла.
`ioVRefNum`	На вводе, спецификации объема. Если Вы указываете допустимый индекс в `ioFCBIndx` поле, Файловый менеджер возвращает информацию о файле, имеющем тот индекс в буфере FCB на объеме, указанном в этом поле. Это поле может содержать число диска или ссылочный номер объема. Если значение `ioVRefNum` 0, все открытые файлы индексируются; иначе, только открытые файлы на указанном объеме индексируются.
`ioRefNum`	На вводе, если ioFCBIndx поле 0, число ссылки на файл файла для получения информации о. Если значение `ioFCBIndx` положительно, `ioRefNum` поле проигнорировано на вводе и содержит число ссылки на файл на выводе.
`ioFCBIndx`	На вводе, индексе. Если значение `ioFCBIndx` положительно, информация о возвратах Файлового менеджера о файле, индекс которого в буфере FCB `ioFCBIndx` и это расположено на объеме, указанном в `ioVRefNum` поле. Если значение `ioFCBIndx` 0, информация о возвратах Файлового менеджера о файле, число ссылки на файл которого указано `ioRefNum` поле.
`ioFCBFlNm`	На выводе, идентификаторе файла.
`ioFCBFlags`	На выводе, флагах состояния файла. См. Флаги FCB для описания битов в этом поле.
`ioFCBStBlk`	На выводе, первом блоке выделения файла.
`ioFCBEOF`	На выводе, логический размер (логический конец файла) файла.
`ioFCBPLen`	На выводе, физический размер (физический конец файла) файла.
`ioFCBCrPs`	На выводе, текущей позиции метки файла.
`ioFCBVRefNum`	На выводе, ссылочном номере объема.
`ioFCBClpSiz`	На выводе, размере глыбы файла.
`ioFCBParID`	На выводе, каталоге ID родительского каталога файла.

Для получения информации о блоке управления ветвления используйте одну из функций, FSGetForkCBInfo , PBGetForkCBInfoSync , или PBGetForkCBInfoAsync.

Специальные замечания

На OS X, значение, возвращенное PBGetFCBInfoSync в ioFCBPLen поле может отличаться от физической длины файла, о которой сообщают FSGetCatalogInfo, PBGetCatInfo, и связанные функции. Когда запись заставляет файл расти в размере, физическая длина, о которой сообщают FSGetCatalogInfo и подобные вызовы увеличиваются размером глыбы, который является кратным числом размера блока выделения. Однако физическая длина, возвращенная PBGetFCBInfoSync изменения согласно размеру блока выделения и длинам файла, возвращенным соответствующими функциями, выходят из синхронизации.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    PBGetFCBInfoAsync
    PBGetFCBInfoAsync

(OS X v10.4)

Получает информацию об открытом файле от блока управления файлом.

Оператор осуждения

Использовать PBGetForkCBInfoAsync вместо этого.

Объявление

Objective C

OSErr PBGetFCBInfoAsync ( FCBPBPtr paramBlock );

Параметры


      paramBlock

Указатель на блок параметра блока управления файлом. Посмотрите FCBPBRec для описания FCBPBRec тип данных.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции.
`ioNamePtr`	На вводе, указателе на путь. Необходимо передать указатель на a `Str31` оцените, если Вы хотите имя возвращенного файла. Если Вы передаете `NULL`, никакое имя файла не возвращается. На выводе, если `PBGetFCBInfoAsync` выполняется успешно, указатель на имя указанного открытого файла.
`ioVRefNum`	На вводе, спецификации объема. Если Вы указываете допустимый индекс в `ioFCBIndx` поле, Файловый менеджер возвращает информацию о файле, имеющем тот индекс в буфере FCB на объеме, указанном в этом поле. Это поле может содержать число диска или ссылочный номер объема. Если значение `ioVRefNum` 0, все открытые файлы индексируются; иначе, только открытые файлы на указанном объеме индексируются.
`ioRefNum`	На вводе, если `ioFCBIndx` поле 0, число ссылки на файл файла для получения информации о. Если значение `ioFCBIndx` положительно, `ioRefNum` поле проигнорировано на вводе и содержит число ссылки на файл на выводе.
`ioFCBIndx`	На вводе, индексе. Если значение `ioFCBIndx` положительно, информация о возвратах Файлового менеджера о файле, индекс которого в буфере FCB `ioFCBIndx` и это расположено на объеме, указанном в `ioVRefNum` поле. Если значение `ioFCBIndx` 0, информация о возвратах Файлового менеджера о файле, число ссылки на файл которого указано `ioRefNum` поле.
`ioFCBFlNm`	На выводе, идентификаторе файла.
`ioFCBFlags`	На выводе, флагах состояния файла. См. Флаги FCB для описания битов в этом поле.
`ioFCBStBlk`	На выводе, первом блоке выделения файла.
`ioFCBEOF`	На выводе, логический размер (логический конец файла) файла.
`ioFCBPLen`	На выводе, физический размер (физический конец файла) файла.
`ioFCBCrPs`	На выводе, позиции метки файла.
`ioFCBVRefNum`	На выводе, ссылочном номере объема.
`ioFCBClpSiz`	На выводе, размере глыбы файла.
`ioFCBParID`	На выводе, каталоге ID родительского каталога файла.

Специальные замечания

На OS X, значение, возвращенное PBGetFCBInfoAsync в ioFCBPLen поле может отличаться от физической длины файла, о которой сообщают FSGetCatalogInfo, PBGetCatInfo, и связанные функции. Когда запись заставляет файл расти в размере, физическая длина, о которой сообщают FSGetCatalogInfo и подобные вызовы увеличиваются размером глыбы, который является кратным числом размера блока выделения. Однако физическая длина, возвращенная PBGetFCBInfoAsync изменения согласно размеру блока выделения и длинам файла, возвращенным соответствующими функциями, выходят из синхронизации.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.

Получая полномочия файла, ACLs и информацию о владении


    
    FSFileSecurityGetOwnerUUID
    FSFileSecurityGetOwnerUUID

(OS X v10.8)

Получает владельца UUID, связанный с a FSFileSecurityRef объект.

Оператор осуждения

Использовать CFFileSecurityCopyOwnerUUID вместо этого.

Объявление

Objective C

OSStatus FSFileSecurityGetOwnerUUID ( FSFileSecurityRef fileSec, CFUUIDBytes *owner );

Параметры

`fileSec`	`FSFileSecurityRef` объект.
`owner`	Указатель на хранение для владельца UUID связался с `fileSec`.

Возвращаемое значение

Возвращает владельца UUID, связанный с данным FSFileSecurityRef объект или errFSPropertyNotValid если нет никакого связанного владельца.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.4 и позже.

Осуждаемый в OS X v10.8.


    
    FSFileSecurityGetGroupUUID
    FSFileSecurityGetGroupUUID

(OS X v10.8)

Получает группу UUID, связанный с a FSFileSecurityRef объект.

Оператор осуждения

Использовать CFFileSecurityCopyGroupUUID вместо этого.

Объявление

Objective C

OSStatus FSFileSecurityGetGroupUUID ( FSFileSecurityRef fileSec, CFUUIDBytes *group );

Параметры

`fileSec`	`FSFileSecurityRef` объект.
`group`	Указатель на хранение для группы UUID связался с `fileSec`.

Возвращаемое значение

Возвращает группу UUID, связанный с данным FSFileSecurityRef объект или errFSPropertyNotValid если нет никакой связанной группы.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.4 и позже.

Осуждаемый в OS X v10.8.


    
    FSFileSecurityCopyAccessControlList
    FSFileSecurityCopyAccessControlList

(OS X v10.8)

Копирует список управления доступом, связанный с данным FSFileSecurityRef объект.

Оператор осуждения

Использовать CFFileSecurityCopyAccessControlList вместо этого.

Объявление

Objective C

OSStatus FSFileSecurityCopyAccessControlList ( FSFileSecurityRef fileSec, acl_t *accessControlList );

Параметры

`fileSec`	`FSFileSecurityRef` объект.
`accessControlList`	Указатель на `acl_t` объект.

Возвращаемое значение

Возвращает копию acl_t объект или errFSPropertyNotValid если нет никакого связанного свойства ACL.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.4 и позже.

Осуждаемый в OS X v10.8.


    
    FSFileSecurityGetOwner
    FSFileSecurityGetOwner

(OS X v10.8)

Получает владельца ID, связанный с данным FSFileSecurityRef объект.

Оператор осуждения

Использовать CFFileSecurityGetOwner вместо этого.

Объявление

Objective C

OSStatus FSFileSecurityGetOwner ( FSFileSecurityRef fileSec, UInt32 *owner );

Параметры

`fileSec`	`FSFileSecurityRef` объект.
`owner`	Владелец ID связался с `FSFileSecurityRef` объект.

Возвращаемое значение

Возвращает владельца ID, связанный с FSFileSecurityRef объект или errFSPropertyNotValid если нет никакого связанного владельца.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.4 и позже.

Осуждаемый в OS X v10.8.


    
    FSFileSecurityGetGroup
    FSFileSecurityGetGroup

(OS X v10.8)

Получает группу ID, связанный с данным FSFileSecurityRef объект.

Оператор осуждения

Использовать CFFileSecurityGetGroup вместо этого.

Объявление

Objective C

OSStatus FSFileSecurityGetGroup ( FSFileSecurityRef fileSec, UInt32 *group );

Параметры

`fileSec`	`FSFileSecurityRef` объект.
`group`	Группа ID связалась с `FSFileSecurityRef` объект.

Возвращаемое значение

Возвращает группу ID, связанный с FSFileSecurityRef объект или errFSPropertyNotValid если нет никакой связанной группы.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.4 и позже.

Осуждаемый в OS X v10.8.


    
    FSFileSecurityGetMode
    FSFileSecurityGetMode

(OS X v10.8)

Связали режим ID с данным FSFileSecurityRef объект.

Оператор осуждения

Использовать CFFileSecurityGetMode вместо этого.

Объявление

Objective C

OSStatus FSFileSecurityGetMode ( FSFileSecurityRef fileSec, UInt16 *mode );

Параметры

`fileSec`	`FSFileSecurityRef` объект.
`mode`	Режим ID связался с `FSFileSecurityRef` объект.

Возвращаемое значение

Возвращает режим ID, связанный с FSFileSecurityRef объект или errFSPropertyNotValid если нет никакого связанного режима.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.4 и позже.

Осуждаемый в OS X v10.8.

FSFileSecurityGetTypeID FSFileSecurityGetTypeID (OS X v10.8)

Получает тип данного FSFileSecurityRef объект.

Оператор осуждения

Использовать CFFileSecurityGetTypeID вместо этого.

Объявление

Objective C

CFTypeID FSFileSecurityGetTypeID ( void );

Возвращаемое значение

Возвраты CFTypeID для данного FSFileSecurityRef объект.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.4 и позже.
Осуждаемый в OS X v10.8.

Получение информации о блоке управления ветвления


    
    FSGetForkCBInfo
    FSGetForkCBInfo

(OS X v10.8)

Информация о возвратах об указанном открытом ветвлении, или обо всех открытых ветвлениях.

Оператор осуждения

На уровне POSIX/BSD использовать fstat(2) OS X Developer Tools Manual Page и lseek(2) OS X Developer Tools Manual Page вместо этого.

Объявление

Objective C

OSErr FSGetForkCBInfo ( FSIORefNum desiredRefNum, FSVolumeRefNum volume, short *iterator, FSIORefNum *actualRefNum, FSForkInfo *forkInfo, FSRef *ref, HFSUniStr255 *outForkName );

Параметры

`desiredRefNum`	Если Вы хотите информацию об определенном ветвлении, устанавливаете этот параметр на ссылочный номер того ветвления и передачу `NULL` в `iterator` параметр. При передаче ненулевого значения в этом параметре функция пытается получить информацию о ветвлении, указанном тем ссылочным номером. Нуль передачи в этом параметре для итерации по всем открытым ветвлениям. Можно ограничить эту итерацию удельным объемом с `volume` параметр.
`volume`	Объем для поиска, при итерации по многократным ветвлениям. Для итерации по всем открытым ветвлениям на единственном объеме укажите ссылочный номер объема в этом параметре. Для итерации по всем открытым ветвлениям на всех объемах установите этот параметр на константу `kFSInvalidVolumeRefNum`. Этот параметр проигнорирован при указании ссылочного номера ветвления в `desiredRefNum` параметр. Набор `desiredRefNum` обнулять, если Вы хотите выполнить итерации по многократным ветвлениям. Посмотрите `FSVolumeRefNum` для описания `FSVolumeRefNum` тип данных.
`iterator`	Указатель на итератор. Если `desiredRefNum` параметр 0, итератор поддерживает состояние между вызовами к `FSGetForkCBInfo`. Установите `iterator` параметр к 0, прежде чем Вы начнете выполнять итерации на первом вызове к `FSGetForkCBInfo`. По возврату будет обновлен итератор; передайте этот обновленный итератор в `iterator` параметр следующего вызова к `FSIterateForks` продолжать выполнять итерации.
`actualRefNum`	По возврату, указателю на ссылочный номер открытого ветвления. Если Вы не хотите получать ссылочный номер ветвления, передачу, этот параметр является дополнительным `NULL`.
`forkInfo`	По возврату, указателю на `FSForkInfo` структура, содержащая информацию об открытом ветвлении. Этот параметр является дополнительным; если Вам не жаль, что эта информация не возвратилась, набор `forkInfo` к `NULL`. Посмотрите `FSForkInfo` для описания `FSForkInfo` тип данных. На OS X, значение, возвращенное `FSGetForkCBInfo` в `physicalEOF` поле `FSForkInfo` структура может отличаться от физической длины файла, о которой сообщают `FSGetCatalogInfo`, `PBGetCatInfo`, и связанные функции. Когда запись заставляет файл расти в размере, физическая длина, о которой сообщают `FSGetCatalogInfo` и подобные вызовы увеличиваются размером глыбы, который является кратным числом размера блока выделения. Однако физическая длина, возвращенная `FSGetForkCBInfo` изменения согласно размеру блока выделения и длинам файла, возвращенным соответствующими функциями, выходят из синхронизации.
`ref`	По возврату, указателю на `FSRef` для файла или каталога, содержащего ветвление. Этот параметр является дополнительным; если Вы не хотите получать `FSRef`, набор `ref` к `NULL`. Посмотрите `FSRef` для описания `FSRef` тип данных.
`outForkName`	По возврату, указателю на имя ветвления. Этот параметр является дополнительным; если Вам не жаль, что имя не возвратилось, набор `outForkName` к `NULL`. Посмотрите `HFSUniStr255` для описания `HFSUniStr255` тип данных.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера. Если Вы выполняете итерации по многократным ветвлениям, функциональным возвратам errFSNoMoreItems при отсутствии более открытых ветвлений для возврата.

Обсуждение

Приложениям углерода больше не гарантируют доступа к таблице FCB. Вместо этого приложения должны использовать FSGetForkCBInfo, или один из связанного параметра блокирует функции, PBGetForkCBInfoSync и PBGetForkCBInfoAsync , к информации о доступе о блоке управления ветвления.

Специальные замечания

Возврат информации о ветвлении в forkInfo параметр обычно не требует доступа к диску; возврат информации в ref или forkName параметры могут вызвать доступ к диску для некоторых форматов объема.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    PBGetForkCBInfoSync
    PBGetForkCBInfoSync

(OS X v10.8)

Информация о возвратах об указанном открытом ветвлении, или обо всех открытых ветвлениях.

Оператор осуждения

На уровне POSIX/BSD использовать fstat(2) OS X Developer Tools Manual Page и lseek(2) OS X Developer Tools Manual Page вместо этого.

Объявление

Objective C

OSErr PBGetForkCBInfoSync ( FSForkCBInfoParam *paramBlock );

Параметры


      paramBlock

Указатель на блок параметра блока управления ветвления. Посмотрите FSForkCBInfoParam для описания FSForkCBInfoParam тип данных.

Возвращаемое значение

Обсуждение

Соответствующие поля блока параметра:

`desiredRefNum`	На вводе, если Вы хотите информацию об определенном ветвлении, устанавливают это поле в ссылочный номер того ветвления. При передаче ненулевого значения в этом параметре функция пытается получить информацию о ветвлении, указанном тем ссылочным номером, поле неизменно на выводе. Нуль передачи в этом поле для итерации по всем открытым ветвлениям; на выводе это поле содержит ссылочный номер ветвления. Можно ограничить эту итерацию удельным объемом с `volumeRefNum` поле.
`volumeRefNum`	На вводе, объем для поиска, при итерации по многократным ветвлениям. Для итерации по всем открытым ветвлениям на единственном объеме укажите ссылочный номер объема в этом поле. Для итерации по всем открытым ветвлениям на всех объемах установите это поле в константу `kFSInvalidVolumeRefNum`. Это поле проигнорировано при указании ссылочного номера ветвления в `desiredRefNum` параметр. Набор `desiredRefNum` обнулять, если Вы хотите выполнить итерации по многократным ветвлениям. Посмотрите `FSVolumeRefNum` для описания `FSVolumeRefNum` тип данных.
`iterator`	На вводе, итераторе. Если `desiredRefNum` параметр 0, итератор поддерживает состояние между вызовами к `PBGetForkCBInfoSync`. Установите `iterator` поле к 0, прежде чем Вы начнете выполнять итерации на первом вызове к `PBGetForkCBInfoSync`. По возврату будет обновлен итератор; передайте этот обновленный итератор в `iterator` поле следующего вызова к `PBGetForkCBInfoSync` продолжать выполнять итерации.
`actualRefNum`	На выводе, фактическом ссылочном номере найденного открытого ветвления.
`ref`	На выводе, указателе на `FSRef` для файла или каталога, содержащего ветвление. Эта информация является дополнительной; если Вы не желаете к `FSRef`, набор `ref` к `NULL`.
`forkInfo`	На выводе, указателе на `FSForkInfo` структура, содержащая информацию об открытом ветвлении. Эта информация является дополнительной; если Вам не жаль, что это не возвратилось, набор `forkInfo` к `NULL`.
`forkName`	На выводе, указателе на имя ветвления. Это поле является дополнительным; если Вам не жаль, что имя не возвратилось, набор `forkName` к `NULL`. Посмотрите `HFSUniStr255` для описания `HFSUniStr255` тип данных.

Приложениям углерода больше не гарантируют доступа к таблице FCB. Вместо этого приложения должны использовать FSGetForkCBInfo , или один из связанного параметра блокирует функции, PBGetForkCBInfoSync и PBGetForkCBInfoAsync , к информации о доступе о блоке управления ветвления.

Специальные замечания

Возврат информации о ветвлении в forkInfo поле обычно не требует доступа к диску; возврат информации в ref или forkName поля могут вызвать доступ к диску для некоторых форматов объема.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    PBGetForkCBInfoAsync
    PBGetForkCBInfoAsync

(OS X v10.8)

Информация о возвратах об указанном открытом ветвлении, или обо всех открытых ветвлениях.

Оператор осуждения

На уровне POSIX/BSD использовать fstat(2) OS X Developer Tools Manual Page и lseek(2) OS X Developer Tools Manual Page вместо этого.

Объявление

Objective C

void PBGetForkCBInfoAsync ( FSForkCBInfoParam *paramBlock );

Параметры


      paramBlock

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции.
`desiredRefNum`	На вводе, если Вы хотите информацию об определенном ветвлении, устанавливают это поле в ссылочный номер того ветвления. При передаче ненулевого значения в этом параметре функция пытается получить информацию о ветвлении, указанном тем ссылочным номером, поле неизменно на выводе. Нуль передачи в этом поле для итерации по всем открытым ветвлениям; на выводе это поле содержит ссылочный номер ветвления. Можно ограничить эту итерацию удельным объемом с `volumeRefNum` поле.
`volumeRefNum`	На вводе, объем для поиска, при итерации по многократным ветвлениям. Для итерации по всем открытым ветвлениям на единственном объеме укажите ссылочный номер объема в этом поле. Для итерации по всем открытым ветвлениям на всех объемах установите это поле в константу `kFSInvalidVolumeRefNum`. Это поле проигнорировано при указании ссылочного номера ветвления в `desiredRefNum` параметр. Набор `desiredRefNum` обнулять, если Вы хотите выполнить итерации по многократным ветвлениям. Посмотрите `FSVolumeRefNum` для описания `FSVolumeRefNum` тип данных.
`iterator`	На вводе, итераторе. Если `desiredRefNum` параметр 0, итератор поддерживает состояние между вызовами к `PBGetForkCBInfoAsync`. Установите `iterator` поле к 0, прежде чем Вы начнете выполнять итерации на первом вызове к `PBGetForkCBInfoAsync`. По возврату будет обновлен итератор; передайте этот обновленный итератор в `iterator` поле следующего вызова к `PBGetForkCBInfoAsync` продолжать выполнять итерации.
`actualRefNum`	На выводе, фактическом ссылочном номере найденного открытого ветвления.
`ref`	На выводе, указателе на `FSRef` для файла или каталога, содержащего ветвление. Эта информация является дополнительной; если Вы не желаете к `FSRef`, набор `ref` к `NULL`.
`forkInfo`	На выводе, указателе на `FSForkInfo` структура, содержащая информацию об открытом ветвлении. Эта информация является дополнительной; если Вам не жаль, что это не возвратилось, набор `forkInfo` к `NULL`.
`forkName`	На выводе, указателе на имя ветвления. Это поле является дополнительным; если Вам не жаль, что имя не возвратилось, набор `forkName` к `NULL`. Посмотрите `HFSUniStr255` для описания `HFSUniStr255` тип данных.

Приложениям углерода больше не гарантируют доступа к таблице FCB. Вместо этого приложения должны использовать FSGetForkCBInfo , или один из связанного параметра блокирует функции, PBGetForkCBInfoSync и PBGetForkCBInfoAsync, к информации о доступе о блоке управления ветвления.

Специальные замечания

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.

Вводные файлы


    
    FSOpenFork
    FSOpenFork

(OS X v10.8)

Открывает любое ветвление файла или каталога для потоковой передачи доступа.

Оператор осуждения

На уровне POSIX/BSD использовать open(2) OS X Developer Tools Manual Page и flock вместо этого. Для открытия ветви данных на уровне Foundation использовать NSFileHandle APIs вместо этого.

Объявление

Objective C

OSErr FSOpenFork ( const FSRef *ref, UniCharCount forkNameLength, const UniChar *forkName, SInt8 permissions, FSIORefNum *forkRefNum );

Параметры

`ref`	Указатель на `FSRef` указание файла или каталога, владеющего ветвлением для открытия. Посмотрите `FSRef` для описания `FSRef` тип данных.
`forkNameLength`	Продолжительность ветвления называет в символах Unicode.
`forkName`	Указатель на имя Unicode ветвления для открытия. Можно получить строковые константы для имен ветви данных и ветви ресурсов с помощью `FSGetDataForkName` и `FSGetResourceForkName` функции. Все форматы объема должны поддерживать ветви данных и ветви ресурсов; другие именованные ветвления могут поддерживаться некоторыми форматами объема.
`permissions`	Постоянное указание типа доступа, который Вы хотите иметь к ветвлению через возвращенную ссылку ветвления. Этот параметр совпадает с `permission` параметр передал `FSpOpenDF` и `FSpOpenRF` функции. Для описания типов доступа, который можно запросить, посмотрите Константы Разрешения Доступа к файлу.
`forkRefNum`	По возврату, указателю на ссылочный номер ветвления для доступа к открытому ветвлению.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера. В некоторых файловых системах, FSOpenFork возвратит ошибку eofErr при попытке открыть ветвь ресурсов файла, для которого никакая ветвь ресурсов не существует с доступом только для чтения.

Обсуждение

Когда Вы используете эту функцию, чтобы открыть файл на локальном томе и передать в значении полномочий fsCurPerm, fsWrPerm, или fsRdWrPerm , OS X не гарантирует монопольный доступ к файлу. Прежде, чем сделать любые предположения о базовом доступе к файлу, необходимо всегда проверять, чтобы видеть, доступна ли функция Supports Exclusive Locks. Если эта функция не доступна, Ваше приложение не может знать, имеет ли другое приложение доступ к тому же файлу. Для получения дополнительной информации посмотрите Техническое примечание ADC TN2037.

Для доступа названный ветвлениями или ветвлениями, больше, чем 2 ГБ, необходимо использовать FSOpenFork функционируйте или один из соответствующих блочных вызовов параметра: PBOpenForkSync и PBOpenForkAsync. Определить если FSOpenFork функция присутствует, вызовите Gestalt функция.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    PBOpenForkSync
    PBOpenForkSync

(OS X v10.8)

Открывает любое ветвление файла или каталога для потоковой передачи доступа.

Оператор осуждения

Объявление

Objective C

OSErr PBOpenForkSync ( FSForkIOParam *paramBlock );

Параметры


      paramBlock

Указатель на ветвление блок параметра I/O. Посмотрите FSForkIOParam для описания FSForkIOParam тип данных.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера. В некоторых файловых системах, PBOpenForkSync возвратит ошибку eofErr при попытке открыть ветвь ресурсов файла, для которого никакая ветвь ресурсов не существует с доступом только для чтения.

Обсуждение

Соответствующие поля блока параметра:

`ref`	На вводе, указателе на `FSRef` указание файла или каталога, которому принадлежит ветвление для открытия.
`forkNameLength`	На вводе, длине имени Unicode ветвления.
`forkName`	На вводе, указателе на имя Unicode ветвления для открытия. Можно получить строковые константы для имен ветви данных и ветви ресурсов с помощью `FSGetDataForkName` и `FSGetResourceForkName` функции. Все форматы объема должны поддерживать ветви данных и ветви ресурсов; другие именованные ветвления могут поддерживаться некоторыми форматами объема.
`permissions`	На вводе, постоянном указании типа доступа, который Вы хотите иметь к ветвлению через возвращенную ссылку ветвления. Этот параметр совпадает с `permission` параметр передал `FSpOpenDF` и `FSpOpenRF` функции. Для описания типов доступа, который можно запросить, посмотрите Константы Разрешения Доступа к файлу.
`forkRefNum`	На выводе, ссылочном номере ветвления для доступа к открытому ветвлению.

Если Вы хотите получить доступ названный ветвлениями или ветвлениями, больше, чем 2 ГБ, необходимо использовать FSOpenFork функционируйте или один из соответствующих блочных вызовов параметра, PBOpenForkSync и PBOpenForkAsync. Определить если PBOpenForkSync функция присутствует, вызовите Gestalt функция.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    PBOpenForkAsync
    PBOpenForkAsync

(OS X v10.8)

Открывает любое ветвление файла или каталога для потоковой передачи доступа.

Оператор осуждения

Объявление

Objective C

void PBOpenForkAsync ( FSForkIOParam *paramBlock );

Параметры


      paramBlock

Указатель на ветвление блок параметра I/O. Посмотрите FSForkIOParam для описания FSForkIOParam тип данных.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции. В некоторых файловых системах, `PBOpenForkAsync` возвратит ошибку `eofErr` при попытке открыть ветвь ресурсов файла, для которого никакая ветвь ресурсов не существует с доступом только для чтения.
`ref`	На вводе, указателе на `FSRef` указание файла или каталога, которому принадлежит ветвление для открытия.
`forkNameLength`	На вводе, длине имени Unicode ветвления.
`forkName`	На вводе, указателе на имя Unicode ветвления для открытия. Можно получить строковые константы для имен ветви данных и ветви ресурсов с помощью `FSGetDataForkName` и `FSGetResourceForkName` функции. Все форматы объема должны поддерживать ветви данных и ветви ресурсов; другие именованные ветвления могут поддерживаться некоторыми форматами объема.
`permissions`	На вводе, постоянном указании типа доступа, который Вы хотите иметь к ветвлению через возвращенную ссылку ветвления. Этот параметр совпадает с `permission` параметр передал `FSpOpenDF` и `FSpOpenRF` функции. Для описания типов доступа, который можно запросить, посмотрите Константы Разрешения Доступа к файлу.
`forkRefNum`	На выводе, ссылочном номере ветвления для доступа к открытому ветвлению.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    FSpOpenDF
    FSpOpenDF

(OS X v10.4)

Открывает ветвь данных файла.

Оператор осуждения

Использовать FSOpenFork вместо этого.

Объявление

Objective C

OSErr FSpOpenDF ( const FSSpec *spec, SInt8 permission, FSIORefNum *refNum );

Параметры

`spec`	Указатель на `FSSpec` структура, указывающая файл, ветвь данных которого должна быть открыта. Посмотрите `FSSpec` для описания `FSSpec` тип данных.
`permission`	Постоянное указание типа доступа, с которым можно открыть ветвь данных файла. В большинстве случаев можно просто установить `permission` параметр к `fsCurPerm`. Некоторый запрос приложений `fsRdWrPerm`, гарантировать, что они могут и читать из и записать в файл. Для описания типов доступа, который можно запросить, посмотрите Константы Разрешения Доступа к файлу.
`refNum`	По возврату, указателю на число ссылки на файл для доступа к открытой ветви данных.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Прежде, чем вызвать эту функцию, необходимо вызвать Gestalt функционируйте, чтобы проверить, что функция доступна. Если FSpOpenDF не доступно, можно использовать функцию HOpenDF вместо этого.

Обратите внимание на то, что, если Вы хотите получить доступ названный ветвлениями кроме ветвей данных и ветвей ресурсов, или ветвлениями, больше, чем 2 ГБ, то необходимо будет использовать FSOpenFork функция или один из ее соответствующего параметра блокирует вызовы, PBOpenForkSync и PBOpenForkAsync. При попытке открыть ветвление, больше, чем 2 ГБ с FSpOpenDF функция, Вы получите сообщение об ошибке.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    HOpenDF
    HOpenDF

(OS X v10.4)

Открывает ветвь данных файла.

Оператор осуждения

Использовать FSOpenFork вместо этого.

Объявление

Objective C

OSErr HOpenDF ( FSVolumeRefNum vRefNum, SInt32 dirID, ConstStr255Param fileName, SInt8 permission, FSIORefNum *refNum );

Параметры

`vRefNum`	Ссылочный номер объема, управляйте числом, или 0 для объема по умолчанию.
`dirID`	Каталог ID родительского каталога файла.
`fileName`	Имя файла.
`permission`	Постоянное указание типа доступа, с которым можно открыть ветвь данных файла. Для описания типов доступа, который можно запросить, посмотрите Константы Разрешения Доступа к файлу.
`refNum`	По возврату, указателю на число ссылки на файл для доступа к открытой ветви данных.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Обратите внимание на то, что, если Вы хотите получить доступ названный ветвлениями кроме ветвей данных и ветвей ресурсов, или ветвлениями, больше, чем 2 ГБ, то необходимо будет использовать FSOpenFork функция или один из соответствующего параметра блокирует вызовы, PBOpenForkSync или PBOpenForkAsync. При попытке открыть ветвление, больше, чем 2 ГБ с HOpenDF функция, Вы получите сообщение об ошибке.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    PBHOpenDFSync
    PBHOpenDFSync

(OS X v10.4)

Открывает ветвь данных файла.

Оператор осуждения

Использовать PBOpenForkSync вместо этого.

Объявление

Objective C

OSErr PBHOpenDFSync ( HParmBlkPtr paramBlock );

Параметры


      paramBlock

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.. При попытке открыть заблокированный файл для записи, PBHOpenDFSync возвращает код результата permErr. Если Вы запрашиваете монопольное разрешение чтения-записи, но другой путь доступа уже открыт, PBHOpenDFSync возвращает ссылочный номер существующего пути доступа в ioRefNum и opWrErr как его функциональный результат.

Обсуждение

Необходимо использовать PBHOpenDFSync вместо PBHOpenSync функция; PBHOpenDFSync позволяет Вам безопасно открывать файл, имя которого начинается с периода (.).

Соответствующие поля блока параметра:

`ioNamePtr`	На вводе, указателе на имя файла.
`ioVRefNum`	На вводе, ссылочном номере объема, числе диска, или 0 для объема по умолчанию.
`ioRefNum`	На выводе, числе ссылки на файл для доступа к открытой ветви данных. Если Вы запрашиваете монопольное разрешение чтения-записи, но другой путь доступа уже открыт, `PBHOpenDFSync` возвращает ссылочный номер существующего пути доступа. Вы не должны использовать этот ссылочный номер, если Ваше приложение первоначально не открыло файл.
`ioPermssn`	На вводе, постоянном указании типа доступа, с которым можно открыть ветвление. Для описания типов доступа можно запросить, видеть Константы Разрешения Доступа к файлу. Можно открыть путь для записи, даже если она получает доступ к файлу на заблокированном объеме, и никакая ошибка не возвращается до a `PBWriteSync`, `PBSetEOFSync` , или `PBAllocateSync` вызов выполняется.
`ioDirID`	На вводе, каталоге ID родительского каталога файла.
`ioFVersNum`	На вводе это поле должно быть инициализировано для обнуления; если это поле не будет нулем, то вызов провалится к теперь устаревшему коду Macintosh File System (MFS), если объем получил доступ, объем MFS.

Обратите внимание на то, что, если Вы хотите получить доступ названный ветвлениями кроме ветвей данных и ветвей ресурсов, или ветвлениями, больше, чем 2 ГБ, то необходимо будет использовать FSOpenFork функция или один из ее соответствующего параметра блокирует вызовы, PBOpenForkSync или PBOpenForkAsync. При попытке открыть ветвление, больше, чем 2 ГБ с PBHOpenDFSync функция, Вы получите сообщение об ошибке.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    PBHOpenDFAsync
    PBHOpenDFAsync

(OS X v10.4)

Открывает ветвь данных файла.

Оператор осуждения

Использовать PBOpenForkAsync вместо этого.

Объявление

Objective C

OSErr PBHOpenDFAsync ( HParmBlkPtr paramBlock );

Параметры


      paramBlock

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Необходимо использовать PBHOpenDFAsync вместо PBHOpenAsync функция; PBHOpenDFAsync позволяет Вам безопасно открывать файл, имя которого начинается с периода (.).

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на функцию завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции. При попытке открыть заблокированный файл для записи, `PBHOpenDFAsync` возвращает код результата `permErr`. Если Вы запрашиваете монопольное разрешение чтения-записи, но другой путь доступа уже открыт, `PBHOpenDFAsync` возвращает ссылочный номер существующего пути доступа в `ioRefNum` и `opWrErr` как его функциональный результат.
`ioNamePtr`	На вводе, указателе на имя файла.
`ioVRefNum`	На вводе, ссылочном номере объема, числе диска, или 0 для объема по умолчанию.
`ioRefNum`	На выводе, числе ссылки на файл для доступа к открытой ветви данных. Если Вы запрашиваете монопольное разрешение чтения-записи, но другой путь доступа уже открыт, `PBHOpenDFAsync` возвращает ссылочный номер существующего пути доступа. Вы не должны использовать этот ссылочный номер, если Ваше приложение первоначально не открыло файл.
`ioPermssn`	На вводе, постоянном указании типа доступа, с которым можно открыть ветвление. Для описания типов доступа можно запросить, видеть Константы Разрешения Доступа к файлу. Можно открыть путь для записи, даже если она получает доступ к файлу на заблокированном объеме, и никакая ошибка не возвращается до a `PBWriteAsync`, `PBSetEOFAsync` , или `PBAllocateAsync` вызов выполняется.
`ioDirID`	На вводе, каталоге ID родительского каталога файла.
`ioFVersNum`	На вводе это поле должно быть инициализировано для обнуления; если это поле не будет нулем, то вызов провалится к теперь устаревшему коду Macintosh File System (MFS), если объем получил доступ, объем MFS.

Обратите внимание на то, что, если Вы хотите получить доступ названный ветвлениями кроме ветвей данных и ветвей ресурсов, или ветвлениями, больше, чем 2 ГБ, то необходимо будет использовать FSOpenFork функция или один из ее соответствующего параметра блокирует вызовы, PBOpenForkSync или PBOpenForkAsync. При попытке открыть ветвление, больше, чем 2 ГБ с PBHOpenDFAsync функция, Вы получите сообщение об ошибке.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    FSpOpenRF
    FSpOpenRF

(OS X v10.4)

Открывает ветвь ресурсов файла.

Оператор осуждения

Использовать FSOpenFork вместо этого.

Объявление

Objective C

OSErr FSpOpenRF ( const FSSpec *spec, SInt8 permission, FSIORefNum *refNum );

Параметры

`spec`	Указатель на `FSSpec` структура, указывающая файл, ветвь ресурсов которого должна быть открыта. Посмотрите `FSSpec` для описания `FSSpec` тип данных.
`permission`	Постоянное указание типа доступа, с которым можно открыть ветвь ресурсов файла. Для описания типов доступа можно запросить, видеть Константы Разрешения Доступа к файлу.
`refNum`	По возврату, указателю на число ссылки на файл для доступа к открытой ветви ресурсов.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера. В некоторых файловых системах, FSpOpenRF возвратит ошибку eofErr при попытке открыть ветвь ресурсов файла, для которого никакая ветвь ресурсов не существует с доступом только для чтения.

Обсуждение

Прежде, чем вызвать эту функцию, необходимо вызвать Gestalt функционируйте, чтобы проверить, что функция доступна. Если FSpOpenRF не доступно, можно использовать функцию HOpenRF вместо этого.

Обратите внимание на то, что, если Вы хотите получить доступ названный ветвлениями кроме ветвей данных и ветвей ресурсов, или ветвлениями, больше, чем 2 ГБ, то необходимо будет использовать FSOpenFork функция или один из ее соответствующего параметра блокирует вызовы, PBOpenForkSync или PBOpenForkAsync. При попытке открыть ветвление, больше, чем 2 ГБ с FSpOpenRF функция, Вы получите сообщение об ошибке.

Специальные замечания

Обычно Ваше приложение должно использовать функции Менеджера ресурсов, а не функции Файлового менеджера для доступа к ветви ресурсов файла. FSpOpenRF функция не читает карту ресурса в память и обычно полезна только для приложений (таких как утилиты, копирующие файлы), что доступ блочного уровня потребности к ветви ресурсов.

Вы не должны использовать ветвь ресурсов файла для содержания неданных ресурсов. Много частей системного программного обеспечения предполагают, что ветвь ресурсов всегда содержит данные ресурсов.

Поскольку нет никакой поддержки блокировки и разблокирования диапазонов файла на локальных дисках в OS X, независимо от того, включен ли Совместный доступ к файлам, Вы не можете открыть больше чем один путь к ветви ресурсов с разрешением чтения-записи. При попытке открыть больше чем один путь к ветви ресурсов файла с fsRdWrShPerm разрешение, только первая попытка успешно выполнится. Последующие попытки возвратят число недопустимой ссылки и ResError функция возвратит ошибку opWrErr.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    HOpenRF
    HOpenRF

(OS X v10.4)

Открывает ветвь ресурсов файла.

Оператор осуждения

Использовать FSOpenFork вместо этого.

Объявление

Objective C

OSErr HOpenRF ( FSVolumeRefNum vRefNum, SInt32 dirID, ConstStr255Param fileName, SInt8 permission, FSIORefNum *refNum );

Параметры

`vRefNum`	Ссылочный номер объема, управляйте числом, или 0 для объема по умолчанию.
`dirID`	Каталог ID для родительского каталога файла.
`fileName`	Имя файла.
`permission`	Постоянное указание типа доступа, с которым можно открыть ветвь ресурсов файла. Для описания типов доступа можно запросить, видеть Константы Разрешения Доступа к файлу.
`refNum`	По возврату, указателю на число ссылки на файл для доступа к открытой ветви ресурсов.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера. При попытке открыть ветвь ресурсов файла, для которого никакая ветвь ресурсов не существует с доступом только для чтения, HOpenRF возвращает ошибку eofErr.

Обсуждение

Обратите внимание на то, что, если Вы хотите получить доступ названный ветвлениями кроме ветвей данных и ветвей ресурсов, или ветвлениями, больше, чем 2 ГБ, то необходимо будет использовать FSOpenFork функция или один из ее соответствующего параметра блокирует вызовы, PBOpenForkSync или PBOpenForkAsync. При попытке открыть ветвление, больше, чем 2 ГБ с HOpenRF функция, Вы получите сообщение об ошибке.

Специальные замечания

Обычно Ваше приложение должно использовать функции Менеджера ресурсов, а не функции Файлового менеджера для доступа к ветви ресурсов файла. HOpenRF функция не читает карту ресурса в память и обычно полезна только для приложений (таких как утилиты, копирующие файлы), что доступ блочного уровня потребности к ветви ресурсов.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    PBHOpenRFSync
    PBHOpenRFSync

(OS X v10.4)

Открывает ветвь ресурсов файла.

Оператор осуждения

Использовать PBOpenForkSync вместо этого.

Объявление

Objective C

OSErr PBHOpenRFSync ( HParmBlkPtr paramBlock );

Параметры


      paramBlock

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера. В некоторых файловых системах, PBHOpenRFSync возвратит ошибку eofErr при попытке открыть ветвь ресурсов файла, для которого никакая ветвь ресурсов не существует с доступом только для чтения.

Обсуждение

Соответствующие поля блока параметра:

`ioNamePtr`	На вводе, указателе на имя файла.
`ioVRefNum`	На вводе, ссылочном номере объема, числе диска, или 0 для объема по умолчанию.
`ioRefNum`	На выводе, числе ссылки на файл для доступа к открытой ветви ресурсов.
`ioPermssn`	На вводе, постоянном указании типа доступа, с которым можно открыть ветвление. Для описания типов доступа можно запросить, видеть Константы Разрешения Доступа к файлу.
`ioDirID`	На вводе, каталоге ID родительского каталога файла.
`ioFVersNum`	На вводе это поле должно быть инициализировано для обнуления; если это поле не будет нулем, то вызов провалится к теперь устаревшему коду Macintosh File System (MFS), если объем получил доступ, объем MFS.

Обратите внимание на то, что, если Вы хотите получить доступ названный ветвлениями кроме ветвей данных и ветвей ресурсов, или ветвлениями, больше, чем 2 ГБ, то необходимо будет использовать FSOpenFork функция или один из ее соответствующего параметра блокирует вызовы, PBOpenForkSync или PBOpenForkAsync. При попытке открыть ветвление, больше, чем 2 ГБ с PBOpenRFSync функция, Вы получите сообщение об ошибке.

Специальные замечания

Обычно Ваше приложение должно использовать функции Менеджера ресурсов, а не функции Файлового менеджера для доступа к ветви ресурсов файла. PBHOpenRFSync функция не читает карту ресурса в память и обычно полезна только для приложений (таких как утилиты, копирующие файлы), что доступ блочного уровня потребности к ветви ресурсов.

Поскольку нет никакой поддержки блокировки и разблокирования диапазонов файла на локальных дисках в OS X, независимо от того, включен ли Совместный доступ к файлам, Вы не можете открыть больше чем один путь к ветви ресурсов с чтением / разрешение записи. При попытке открыть больше чем один путь к ветви ресурсов файла с fsRdWrShPerm разрешение, только первая попытка успешно выполнится. Последующие попытки возвратят число недопустимой ссылки и ResError функция возвратит ошибку opWrErr.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    PBHOpenRFAsync
    PBHOpenRFAsync

(OS X v10.4)

Открывает ветвь ресурсов файла.

Оператор осуждения

Использовать PBOpenForkAsync вместо этого.

Объявление

Objective C

OSErr PBHOpenRFAsync ( HParmBlkPtr paramBlock );

Параметры


      paramBlock

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на функцию завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции. В некоторых файловых системах, `PBHOpenRFAsync` возвратит ошибку `eofErr` при попытке открыть ветвь ресурсов файла, для которого никакая ветвь ресурсов не существует с доступом только для чтения.
`ioNamePtr`	На вводе, указателе на имя файла.
`ioVRefNum`	На вводе, ссылочном номере объема, числе диска, или 0 для объема по умолчанию.
`ioRefNum`	На выводе, числе ссылки на файл для доступа к открытой ветви ресурсов.
`ioPermssn`	На вводе, постоянном указании типа доступа, с которым можно открыть ветвление. Для описания типов доступа можно запросить, видеть Константы Разрешения Доступа к файлу.
`ioDirID`	На вводе, каталоге ID родительского каталога файла.
`ioFVersNum`	На вводе это поле должно быть инициализировано для обнуления; если это поле не будет нулем, то вызов провалится к теперь устаревшему коду Macintosh File System (MFS), если объем получил доступ, объем MFS.

Обратите внимание на то, что, если Вы хотите получить доступ названный ветвлениями кроме ветвей данных и ветвей ресурсов, или ветвлениями, больше, чем 2 ГБ, то необходимо будет использовать FSOpenFork функция или один из ее соответствующего параметра блокирует вызовы, PBOpenForkSync или PBOpenForkAsync. При попытке открыть ветвление, больше, чем 2 ГБ с PBHOpenRFAsync функция, Вы получите сообщение об ошибке.

Специальные замечания

Обычно Ваше приложение должно использовать функции Менеджера ресурсов, а не функции Файлового менеджера для доступа к ветви ресурсов файла. PBHOpenRFAsync функция не читает карту ресурса в память и обычно полезна только для приложений (таких как утилиты, копирующие файлы), что доступ блочного уровня потребности к ветви ресурсов.

Поскольку нет никакой поддержки блокировки и разблокирования диапазонов файла в OS X, независимо от того, включен ли Совместный доступ к файлам, Вы не можете открыть больше чем один путь к ветви ресурсов с чтением / разрешение записи. При попытке открыть больше чем один путь к ветви ресурсов файла с fsRdWrShPerm разрешение, только первая попытка успешно выполнится. Последующие попытки возвратят число недопустимой ссылки и ResError функция возвратит ошибку opWrErr.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    HOpen
    HOpen

(OS X v10.4)

Открывает ветвь данных файла.

Оператор осуждения

Использовать FSOpenFork вместо этого.

Объявление

Objective C

OSErr HOpen ( FSVolumeRefNum vRefNum, SInt32 dirID, ConstStr255Param fileName, SInt8 permission, FSIORefNum *refNum );

Параметры

`vRefNum`	Ссылочный номер объема, управляйте числом, или 0 для объема по умолчанию.
`dirID`	Каталог ID родительского каталога файла.
`fileName`	Имя файла.
`permission`	Постоянное указание типа доступа, с которым можно открыть ветвь данных файла. Для описания типов доступа можно запросить, видеть Константы Разрешения Доступа к файлу.
`refNum`	По возврату, указателю на число ссылки на файл для доступа к открытому ветвлению.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Если Вы используете HOpen чтобы попытаться открыть файл, имя которого начинается с периода, Вы могли бы по ошибке открыть драйвер вместо этого; последующие попытки записать данные могли бы повредить данные по целевому устройству. Для предотвращения этих проблем необходимо всегда использовать HOpenDF вместо HOpen.

Специальные замечания

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    PBHOpenSync
    PBHOpenSync

(OS X v10.4)

Открывает ветвь данных файла.

Оператор осуждения

Использовать PBOpenForkSync вместо этого.

Объявление

Objective C

OSErr PBHOpenSync ( HParmBlkPtr paramBlock );

Параметры


      paramBlock

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера. При попытке открыть заблокированный файл для записи, PBHOpenSync возвращает код результата permErr. Если Вы запрашиваете монопольное разрешение чтения-записи, но другой путь доступа уже открыт, PBHOpenSync возвращает ссылочный номер существующего пути доступа в ioRefNum и opWrErr как его функциональный результат.

Обсуждение

Соответствующие поля блока параметра:

`ioNamePtr`	На вводе, указателе на имя файла.
`ioVRefNum`	На вводе, ссылочном номере объема, числе диска, или 0 для объема по умолчанию.
`ioRefNum`	На выводе, числе ссылки на файл для доступа к открытой ветви данных. Если Вы запрашиваете монопольное разрешение чтения-записи, но другой путь доступа уже открыт, `PBHOpenSync` возвращает ссылочный номер существующего пути доступа. Вы не должны использовать этот ссылочный номер, если Ваше приложение первоначально не открыло файл.
`ioPermssn`	На вводе, постоянном указании типа доступа, с которым можно открыть ветвление. Для описания типов доступа можно запросить, видеть Константы Разрешения Доступа к файлу. Можно открыть путь для записи, даже если она получает доступ к файлу на заблокированном объеме, и никакая ошибка не возвращается до a `PBWriteSync`, `PBSetEOFSync` , или `PBAllocateSync` вызов выполняется.
`ioDirID`	На вводе, каталоге ID родительского каталога файла.
`ioFVersNum`	На вводе это поле должно быть инициализировано для обнуления; если это поле не будет нулем, то вызов провалится к теперь устаревшему коду Macintosh File System (MFS), если объем получил доступ, объем MFS.

Если Вы используете PBHOpenSync чтобы попытаться открыть файл, имя которого начинается с периода, Вы могли бы по ошибке открыть драйвер вместо этого; последующие попытки записать данные могли бы повредить данные по целевому устройству. Для предотвращения этих проблем необходимо всегда использовать PBHOpenDFSync вместо PBHOpenSync.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    PBHOpenAsync
    PBHOpenAsync

(OS X v10.4)

Открывает ветвь данных файла.

Оператор осуждения

Использовать PBOpenForkAsync вместо этого.

Объявление

Objective C

OSErr PBHOpenAsync ( HParmBlkPtr paramBlock );

Параметры


      paramBlock

Указатель на основной блок параметра HFS.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на функцию завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции. При попытке открыть заблокированный файл для записи, `PBHOpenAsync` возвращает код результата `permErr`. Если Вы запрашиваете монопольное разрешение чтения-записи, но другой путь доступа уже открыт, `PBHOpenAsync` возвращает ссылочный номер существующего пути доступа в `ioRefNum` и `opWrErr` как его функциональный результат.
`ioNamePtr`	На вводе, указателе на имя файла.
`ioVRefNum`	На вводе, ссылочном номере объема, числе диска, или 0 для объема по умолчанию.
`ioRefNum`	На выводе, числе ссылки на файл для доступа к открытой ветви данных. Если Вы запрашиваете монопольное разрешение чтения-записи, но другой путь доступа уже открыт, `PBHOpenAsync` возвращает ссылочный номер существующего пути доступа. Вы не должны использовать этот ссылочный номер, если Ваше приложение первоначально не открыло файл.
`ioPermssn`	На вводе, постоянном указании типа доступа, с которым можно открыть ветвление. Для описания типов доступа можно запросить, видеть Константы Разрешения Доступа к файлу. Можно открыть путь для записи, даже если она получает доступ к файлу на заблокированном объеме, и никакая ошибка не возвращается до a `PBWriteAsync`, `PBSetEOFAsync` , или `PBAllocateAsync` вызов выполняется.
`ioDirID`	На вводе, каталоге ID родительского каталога файла.
`ioFVersNum`	На вводе это поле должно быть инициализировано для обнуления; если это поле не будет нулем, то вызов провалится к теперь устаревшему коду Macintosh File System (MFS), если объем получил доступ, объем MFS.

Если Вы используете PBHOpenAsync чтобы попытаться открыть файл, имя которого начинается с периода, Вы могли бы по ошибке открыть драйвер вместо этого; последующие попытки записать данные могли бы повредить данные по целевому устройству. Для предотвращения этих проблем необходимо всегда использовать PBHOpenDFAsync вместо PBHOpenAsync.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.

Вводные файлы при запрете доступа


    
    PBHOpenDenySync
    PBHOpenDenySync

(OS X v10.5)

Открывается ветвь данных файла с помощью доступа отклоняют режимы.

Оператор осуждения

Использовать PBOpenForkSync с отклоняют режимы в поле полномочий.

Объявление

Objective C

OSErr PBHOpenDenySync ( HParmBlkPtr paramBlock );

Параметры


      paramBlock

Указатель на AccessParam вариант основного блока параметра HFS. Посмотрите HParamBlockRec для описания HParamBlockRec тип данных.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера. Функция возвращает код результата opWrErr если Вы запросили разрешение записи, и Вы уже открыли файл для записи в этом случае, существующее число ссылки на файл возвращается в ioRefNum. Вы не должны использовать этот ссылочный номер, если Ваше приложение первоначально не открыло файл.

Обсуждение

Соответствующие поля блока параметра:

`ioNamePtr`	На вводе, указателе на путь для файла.
`ioVRefNum`	На вводе, ссылочном номере объема или числе диска для объема, содержащего файл. Передайте 0 для указания объема по умолчанию.
`ioRefNum`	На выводе, числе ссылки на файл для файла.
`ioDenyModes`	На вводе типе доступа Вы запрашиваете к ветвлению. Посмотрите Константы Разрешения Доступа к файлу для описания типов доступа, который можно запросить.
`ioDirID`	На вводе, родительский каталог ID файла.

Необходимо использовать PBHOpenDenySync и PBHOpenRFDenySync функции (или их асинхронные дубликаты, PBHOpenDenyAsync и PBHOpenRFDenyAsync ) если Вы хотите гарантировать, чтобы Вы получили права доступа и полномочия отклонять-режима, которые Вы запрашиваете. PBHOpenDenySync не повторен всегда. Если файл не может быть открыт из-за отклонять конфликта, ошибки afpDenyConflict возвращается и ioRefNum поле установлено в 0.

Можно проверить, что объем поддерживает полномочия отклонять-режима AFP путем проверки что bHasOpenDeny бит установлен в vMAttrib поле, возвращенное PBHGetVolParmsSync или PBHGetVolParmsAsync функция. Если Вы не хотите к объемам особого случая, что поддержка, AFP отклоняет полномочия режима, можно использовать полномочия Файлового менеджера. Посмотрите Константы Разрешения Доступа к файлу для описания того, как полномочия Файлового менеджера переводятся в полномочия отклонять-режима AFP.

Для открытия ветви ресурсов файла с доступом отклоняют полномочия, используют PBHOpenRFDenySync или PBHOpenRFDenyAsync функция.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.5.

Не доступный 64-разрядным приложениям.


    
    PBHOpenDenyAsync
    PBHOpenDenyAsync

(OS X v10.5)

Открывается ветвь данных файла с помощью доступа отклоняют режимы.

Оператор осуждения

Использовать PBOpenForkAsync с отклоняют режимы в поле полномочий.

Объявление

Objective C

OSErr PBHOpenDenyAsync ( HParmBlkPtr paramBlock );

Параметры


      paramBlock

Указатель на основной блок параметра HFS.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции. Функция возвращает код результата `opWrErr` если Вы запросили разрешение записи, и Вы уже открыли файл для записи в этом случае, существующее число ссылки на файл возвращается в `ioRefNum`. Вы не должны использовать этот ссылочный номер, если Ваше приложение первоначально не открыло файл.
`ioNamePtr`	На вводе, указателе на путь для файла.
`ioVRefNum`	На вводе, ссылочном номере объема или числе диска для объема, содержащего файл. Передайте 0 для указания объема по умолчанию.
`ioRefNum`	На выводе, числе ссылки на файл для файла.
`ioDenyModes`	На вводе типе доступа Вы запрашиваете к ветвлению. Посмотрите Константы Разрешения Доступа к файлу для описания типов доступа, который можно запросить.
`ioDirID`	На вводе, родительский каталог ID файла.

Необходимо использовать PBHOpenDenyAsync и PBHOpenRFDenyAsync функции (или их синхронные дубликаты, PBHOpenDenySync и PBHOpenRFDenySync ) если Вы хотите гарантировать, чтобы Вы получили права доступа и полномочия отклонять-режима, которые Вы запрашиваете. PBHOpenDenyAsync не повторен всегда. Если файл не может быть открыт из-за отклонять конфликта, ошибки afpDenyConflict возвращается и ioRefNum поле установлено в 0.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.5.

Не доступный 64-разрядным приложениям.


    
    PBHOpenRFDenySync
    PBHOpenRFDenySync

(OS X v10.5)

Открывается ветвь ресурсов файла с помощью доступа отклоняют режимы.

Оператор осуждения

Использовать PBOpenForkSync с отклоняют режимы в поле полномочий.

Объявление

Objective C

OSErr PBHOpenRFDenySync ( HParmBlkPtr paramBlock );

Параметры


      paramBlock

Возвращаемое значение

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на функцию завершения.
`ioResult`	На выводе, коде результата функции.
`ioNamePtr`	На вводе, указателе на путь для файла.
`ioVRefNum`	На вводе, ссылочном номере объема или числе диска для объема, содержащего файл. Передайте 0 для указания объема по умолчанию.
`ioRefNum`	На выводе, числе ссылки на файл для файла.
`ioDenyModes`	На вводе типе доступа Вы запрашиваете к ветвлению. Посмотрите Константы Разрешения Доступа к файлу для описания типов доступа, который можно запросить.
`ioDirID`	На вводе, родительский каталог ID файла.

Необходимо использовать PBHOpenRFDenySync и PBHOpenDenySync функции (или их асинхронные дубликаты, PBHOpenRFDenyAsync и PBHOpenDenyAsync ) если Вы хотите гарантировать, чтобы Вы получили права доступа и полномочия отклонять-режима, которые Вы запрашиваете. PBHOpenRFDenySync не повторен всегда. Если файл не может быть открыт из-за отклонять конфликта, ошибки afpDenyConflict возвращается и ioRefNum поле установлено в 0.

Для открытия ветви данных файла с доступом отклоняют полномочия, используют PBHOpenDenySync или PBHOpenDenyAsync функция.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.5.

Не доступный 64-разрядным приложениям.


    
    PBHOpenRFDenyAsync
    PBHOpenRFDenyAsync

(OS X v10.5)

Открывается ветвь ресурсов файла с помощью доступа отклоняют режимы.

Оператор осуждения

Использовать PBOpenForkAsync с отклоняют режимы в поле полномочий.

Объявление

Objective C

OSErr PBHOpenRFDenyAsync ( HParmBlkPtr paramBlock );

Параметры


      paramBlock

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции. Функция возвращает код результата `opWrErr` если Вы запросили разрешение записи, и Вы уже открыли файл для записи в этом случае, существующее число ссылки на файл возвращается в `ioRefNum`. Вы не должны использовать этот ссылочный номер, если Ваше приложение первоначально не открыло файл.
`ioNamePtr`	На вводе, указателе на путь для файла.
`ioVRefNum`	На вводе, ссылочном номере объема или числе диска для объема, содержащего файл. Передайте 0 для указания объема по умолчанию.
`ioRefNum`	На выводе, числе ссылки на файл для файла.
`ioDenyModes`	На вводе типе доступа Вы запрашиваете к ветвлению. Посмотрите Константы Разрешения Доступа к файлу для описания типов доступа, который можно запросить.
`ioDirID`	На вводе, родительский каталог ID файла.

Необходимо использовать PBHOpenRFDenyAsync и PBHOpenDenyAsync функции (или их синхронные дубликаты, PBHOpenRFDenySync и PBHOpenDenySync ) если Вы хотите гарантировать, чтобы Вы получили права доступа и полномочия отклонять-режима, которые Вы запрашиваете. PBHOpenRFDenyAsync не повторен всегда. Если файл не может быть открыт из-за отклонять конфликта, ошибки afpDenyConflict возвращается и ioRefNum поле установлено в 0.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.5.

Не доступный 64-разрядным приложениям.

Чтение и запись файлов


    
    FSReadFork
    FSReadFork

(OS X v10.8)

Считывает данные из открытого ветвления.

Оператор осуждения

На уровне POSIX/BSD использовать read(2) OS X Developer Tools Manual Page вместо этого. Управлять кэширующимся использованием fcntl с F_NOCACHE. Для чтения ветви данных на уровне Foundation использовать NSFileHandle APIs вместо этого.

Объявление

Objective C

OSErr FSReadFork ( FSIORefNum forkRefNum, UInt16 positionMode, SInt64 positionOffset, ByteCount requestCount, void *buffer, ByteCount *actualCount );

Параметры

`forkRefNum`	Ссылочный номер ветвления для чтения из. Необходимо было ранее открыть это ветвление с помощью `FSOpenFork` вызовите, или один из соответствующих блочных вызовов параметра, `PBOpenForkSync` и `PBOpenForkAsync`.
`positionMode`	Постоянное указание основного расположения в ветвлении для запуска чтения. Посмотрите Константы Режима Позиции для описания констант, которые можно использовать для указания основного расположения. Вызывающая сторона может также использовать этот параметр для вывода подсказок Файловому менеджеру, должны ли считанные данные или не должны кэшироваться. Кэширование чтений соответственно может быть важным в обеспечении что Ваши файлы доступа программы эффективно. Если Вы добавляете `forceReadMask` постоянный к значению Вы передаете в этом параметре, это говорит Файловому менеджеру вынуждать данные быть считанными непосредственно из диска. Это отличается от добавления `noCacheMask` постоянный с тех пор `forceReadMask` говорит Файловому менеджеру сбрасывать надлежащую часть кэша сначала, затем игнорировать любые данные уже в кэше. Однако считанные данные могут быть помещены в кэш для будущих чтений. `forceReadMask` постоянный также передается драйверу устройства, указывая, что драйвер должен избежать читать из любых кэшей устройства. Посмотрите Константы Кэша для дальнейшего описания констант, которые можно использовать для указания предпочтения кэширования чтения.
`positionOffset`	Смещение от основного расположения для запуска чтения.
`requestCount`	Число байтов для чтения.
`buffer`	Указатель на буфер, куда будут возвращены данные.
`actualCount`	По возврату фактически читал указатель на число байтов. Значение, на которое указывают `actualCount` параметр должен быть равен значению в `requestCount` параметр, если не была ошибка во время операции чтения. Этот параметр является дополнительным; если Вы не хотите эту возвращенную информацию, набор `actualCount` к `NULL`.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера. Если существуют меньше, чем requestCount байты от указанной позиции до логического конца файла, тогда все те байты читаются, и eofErr возвращается.

Обсуждение

FSReadFork данные чтений, запускающиеся в позиции, указанной positionMode и positionOffset параметры. Функция читает до requestCount байты в буфер, на который указывают buffer параметр и наборы текущая позиция ветвления к байту сразу после последнего побайтового чтения (т.е. начальная позиция плюс actualCount).

Чтобы проверить, что данные, ранее записанные, были правильно переданы диску, считайте его назад в использовании forceReadMask постоянный в positionMode параметр и сравнивает его с данными, которые Вы ранее записали.

При чтении данных из ветвления важно обратить внимание на тот способ, которым программа получает доступ к ветвлению, потому что это может оказать значительное влияние производительности. Для лучших результатов необходимо использовать размер I/O по крайней мере 4 КБ, и блок выравнивают запросы чтения. В OS X необходимо выровнять запросы к границам 4 КБ.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    PBReadForkSync
    PBReadForkSync

(OS X v10.8)

Считывает данные из открытого ветвления.

Оператор осуждения

Объявление

Objective C

OSErr PBReadForkSync ( FSForkIOParam *paramBlock );

Параметры


      paramBlock

Указатель на ветвление блок параметра I/O. Посмотрите FSForkIOParam для описания FSForkIOParam тип данных.

Возвращаемое значение

Обсуждение

Соответствующие поля блока параметра:

`forkRefNum`	На вводе, ссылочном номере ветвления для чтения из. Необходимо было ранее открыть это ветвление с помощью `FSOpenFork` вызовите, или один из соответствующих блочных вызовов параметра, `PBOpenForkSync` и `PBOpenForkAsync`.
`positionMode`	На вводе, постоянном указании основного расположения в ветвлении для запуска чтения. Посмотрите Константы Режима Позиции для описания констант, которые можно использовать для указания основного расположения. Вызывающая сторона может также использовать этот параметр для вывода подсказок Файловому менеджеру, должны ли считанные данные или не должны кэшироваться. Кэширование чтений соответственно может быть важным в обеспечении что Ваши файлы доступа программы эффективно. Если Вы добавляете `forceReadMask` постоянный к значению Вы передаете в этом параметре, это говорит Файловому менеджеру вынуждать данные быть считанными непосредственно из диска. Это отличается от добавления `noCacheMask` постоянный с тех пор `forceReadMask` говорит Файловому менеджеру сбрасывать надлежащую часть кэша сначала, затем игнорировать любые данные уже в кэше. Однако считанные данные могут быть помещены в кэш для будущих чтений. `forceReadMask` постоянный также передается драйверу устройства, указывая, что драйвер должен избежать читать из любых кэшей устройства. Посмотрите Константы Кэша для дальнейшего описания констант, которые можно использовать для указания предпочтения кэширования чтения.
`positionOffset`	На вводе, смещении от основного расположения для запуска чтения.
`requestCount`	На вводе, числе байтов для чтения. Значение, которое Вы передаете в этом поле, должно быть больше, чем нуль.
`buffer`	Указатель на буфер, куда будут возвращены данные.
`actualCount`	На выводе фактически читало число байтов. Значение в этом поле должно быть равно значению в `requestCount` поле, если не была ошибка во время операции чтения.

PBReadForkSync данные чтений, запускающиеся в позиции, указанной positionMode и positionOffset поля. Функция читает до requestCount байты в буфер, на который указывают buffer поле и наборы текущая позиция ветвления к байту сразу после последнего побайтового чтения (т.е. начальная позиция плюс actualCount).

Чтобы проверить, что данные, ранее записанные, были правильно переданы диску, считайте его назад в использовании forceReadMask постоянный в positionMode поле и сравнивает его с данными, которые Вы ранее записали.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    PBReadForkAsync
    PBReadForkAsync

(OS X v10.8)

Считывает данные из открытого ветвления.

Оператор осуждения

Объявление

Objective C

void PBReadForkAsync ( FSForkIOParam *paramBlock );

Параметры


      paramBlock

Указатель на ветвление блок параметра I/O. Посмотрите FSForkIOParam для описания FSForkIOParam тип данных.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции. Если существуют меньше, чем `requestCount` байты от указанной позиции до логического конца файла, тогда все те байты читаются, и `eofErr` возвращается.
`forkRefNum`	На вводе, ссылочном номере ветвления для чтения из. Необходимо было ранее открыть это ветвление с помощью `FSOpenFork` вызовите, или один из соответствующих блочных вызовов параметра, `PBOpenForkSync` и `PBOpenForkAsync`.
`positionMode`	На вводе, постоянном указании основного расположения в ветвлении для запуска чтения. Посмотрите Константы Режима Позиции для описания констант, которые можно использовать для указания основного расположения. Вызывающая сторона может также использовать этот параметр для вывода подсказок Файловому менеджеру, должны ли считанные данные или не должны кэшироваться. Кэширование чтений соответственно может быть важным в обеспечении что Ваши файлы доступа программы эффективно. Если Вы добавляете `forceReadMask` постоянный к значению Вы передаете в этом параметре, это говорит Файловому менеджеру вынуждать данные быть считанными непосредственно из диска. Это отличается от добавления `noCacheMask` постоянный с тех пор `forceReadMask` говорит Файловому менеджеру сбрасывать надлежащую часть кэша сначала, затем игнорировать любые данные уже в кэше. Однако считанные данные могут быть помещены в кэш для будущих чтений. `forceReadMask` постоянный также передается драйверу устройства, указывая, что драйвер должен избежать читать из любых кэшей устройства. Посмотрите Константы Кэша для дальнейшего описания констант, которые можно использовать для указания предпочтения кэширования чтения.
`positionOffset`	На вводе, смещении от основного расположения для запуска чтения.
`requestCount`	На вводе, числе байтов для чтения. Значение, которое Вы передаете в этом поле, должно быть больше, чем нуль.
`buffer`	Указатель на буфер, куда будут возвращены данные.
`actualCount`	На выводе фактически читало число байтов. Значение в этом поле должно быть равно значению в `requestCount` поле, если не была ошибка во время операции чтения.

PBReadForkAsync данные чтений, запускающиеся в позиции, указанной positionMode и positionOffset поля. Функция читает до requestCount байты в буфер, на который указывают buffer поле и наборы текущая позиция ветвления к байту сразу после последнего побайтового чтения (т.е. начальная позиция плюс actualCount).

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    FSWriteFork
    FSWriteFork

(OS X v10.8)

Данные записей к открытому ветвлению.

Оператор осуждения

На уровне POSIX/BSD использовать write(2) OS X Developer Tools Manual Page вместо этого. Для управления кэшированием использовать fcntl с F_NOCACHE. Для записи данных в ветвь данных на уровне Foundation использовать NSFileHandle APIs вместо этого.

Объявление

Objective C

OSErr FSWriteFork ( FSIORefNum forkRefNum, UInt16 positionMode, SInt64 positionOffset, ByteCount requestCount, const void *buffer, ByteCount *actualCount );

Параметры

`forkRefNum`	Ссылочный номер ветвления, в которое можно записать. Необходимо было ранее открыть ветвление с помощью `FSOpenFork` функция или один из соответствующего параметра блокирует вызовы, `PBOpenForkSync` и `PBOpenForkAsync`.
`positionMode`	Постоянное указание основного расположения в ветвлении для запуска записи. Посмотрите Константы Режима Позиции для описания констант, которые можно использовать для указания основного расположения. Вызывающая сторона может также использовать этот параметр для вывода подсказок Файловому менеджеру, должны ли записанные данные или не должны кэшироваться. Посмотрите Константы Кэша для дальнейшего описания констант, которые можно использовать для указания предпочтения кэширования.
`positionOffset`	Смещение от основного расположения для запуска записи.
`requestCount`	Число байтов для записи.
`buffer`	Указатель на буфер, содержащий данные для записи.
`actualCount`	По возврату, указателю на число байтов, фактически записанных. Значение, на которое указывают `actualCount` параметр будет равен значению в `requestCount` параметр, если не была ошибка во время операции записи. Этот параметр является дополнительным; если Вы не хотите эту информацию, установить `actualCount` к `NULL`.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера. Если существует недостаточно пространства на объеме для записи requestCount байты, тогда dskFulErr возвращается.

Обсуждение

FSWriteFork данные записей, запускающиеся в позиции, указанной positionMode и positionOffset параметры. Функция пытается записать requestCount байты от буфера, на который указывают buffer параметр и наборы текущая позиция ветвления к байту сразу после последнего записанного байта (т.е. начальная позиция плюс actualCount).

При записи данных в ветвление важно обратить внимание на тот способ, которым программа получает доступ к ветвлению, потому что это может оказать значительное влияние производительности. Для лучших результатов необходимо использовать размер I/O по крайней мере 4 КБ, и блок выравнивают запросы записи. В OS X необходимо выровнять запросы к границам 4 КБ.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    PBWriteForkSync
    PBWriteForkSync

(OS X v10.8)

Данные записей к открытому ветвлению.

Оператор осуждения

Объявление

Objective C

OSErr PBWriteForkSync ( FSForkIOParam *paramBlock );

Параметры


      paramBlock

Указатель на ветвление блок параметра I/O. Посмотрите FSForkIOParam для описания FSForkIOParam.

Возвращаемое значение

Обсуждение

Соответствующие поля блока параметра:

`ioResult`	На выводе, коде результата функции. Если существует недостаточно пространства на объеме для записи `requestCount` байты, тогда `dskFulErr` возвращается.
`forkRefNum`	На вводе, ссылочном номере ветвления, в которое можно записать. Необходимо было ранее открыть ветвление с помощью `FSOpenFork` функция или один из соответствующего параметра блокирует вызовы, `PBOpenForkSync` и `PBOpenForkAsync`.
`positionMode`	На вводе, постоянном указании основного расположения в ветвлении для запуска записи. Посмотрите Константы Режима Позиции для описания констант, которые можно использовать для указания основного расположения. Вызывающая сторона может также использовать этот параметр для вывода подсказок Файловому менеджеру, должны ли записанные данные или не должны кэшироваться. Посмотрите Константы Кэша для дальнейшего описания констант, которые можно использовать для указания предпочтения кэширования.
`positionOffset`	На вводе, смещении от основного расположения для запуска записи.
`requestCount`	На вводе, числе байтов для записи.
`buffer`	Указатель на буфер, содержащий данные для записи.
`actualCount`	На выводе, числе байтов, фактически записанных. Значение в `actualCount` поле будет равно значению в `requestCount` поле, если не была ошибка во время операции записи.

PBWriteForkSync данные записей, запускающиеся в позиции, указанной positionMode и positionOffset поля. Функция пытается записать requestCount байты от буфера, на который указывают buffer поле и наборы текущая позиция ветвления к байту сразу после последнего записанного байта (т.е. начальная позиция плюс actualCount).

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    PBWriteForkAsync
    PBWriteForkAsync

(OS X v10.8)

Данные записей к открытому ветвлению.

Оператор осуждения

Объявление

Objective C

void PBWriteForkAsync ( FSForkIOParam *paramBlock );

Параметры


      paramBlock

Указатель на ветвление блок параметра I/O. Посмотрите FSForkIOParam для описания FSForkIOParam.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции. Если существует недостаточно пространства на объеме для записи `requestCount` байты, тогда `dskFulErr` возвращается.
`forkRefNum`	На вводе, ссылочном номере ветвления, в которое можно записать. Необходимо было ранее открыть ветвление с помощью `FSOpenFork` функция или один из соответствующего параметра блокирует вызовы, `PBOpenForkSync` и `PBOpenForkAsync`.
`positionMode`	На вводе, постоянном указании основного расположения в ветвлении для запуска записи. Посмотрите Константы Режима Позиции для описания констант, которые можно использовать для указания основного расположения. Вызывающая сторона может также использовать этот параметр для вывода подсказок Файловому менеджеру, должны ли записанные данные или не должны кэшироваться. Посмотрите Константы Кэша для дальнейшего описания констант, которые можно использовать для указания предпочтения кэширования.
`positionOffset`	На вводе, смещении от основного расположения для запуска записи.
`requestCount`	На вводе, числе байтов для записи.
`buffer`	Указатель на буфер, содержащий данные для записи.
`actualCount`	На выводе, числе байтов, фактически записанных. Значение в `actualCount` поле будет равно значению в `requestCount` поле, если не была ошибка во время операции записи.

PBWriteForkAsync данные записей, запускающиеся в позиции, указанной positionMode и positionOffset поля. Функция пытается записать requestCount байты от буфера, на который указывают buffer поле и наборы текущая позиция ветвления к байту сразу после последнего записанного байта (т.е. начальная позиция плюс actualCount).

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    FSRead
    FSRead

(OS X v10.4)

Чтения любое число байтов от открытого файла.

Оператор осуждения

Использовать FSReadFork вместо этого.

Объявление

Objective C

OSErr FSRead ( FSIORefNum refNum, SInt32 *count, void *buffPtr );

Параметры

`refNum`	Число ссылки на файл открытого файла, из которого можно читать.
`count`	На вводе, указателе на число байтов для чтения; на выводе фактически читал указатель на число байтов.
`buffPtr`	Указатель на буфер данных, в который будут считаны данные. Этот буфер выделяется Вашим приложением и должен быть, по крайней мере, столь же большим как `count` параметр.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Поскольку операция чтения начинается в текущей метке, Вы могли бы хотеть установить метку сначала путем вызова SetFPos функция. При попытке читать мимо логического конца файла, FSRead чтения во всех данных до конца файла, перемещает метку до конца файла и возвраты eofErr как его функциональный результат. Иначе, FSRead перемещает метку файла в байт после последнего побайтового чтения и возвратов noErr.

Низкоуровневые функции PBReadSync и PBReadAsync позвольте Вам установить метку, не имея необходимость вызывать SetFPos. Кроме того, если Вы хотите считать данные в режиме новой строки, необходимо использовать PBReadSync или PBReadAsync вместо FSRead.

Если Вы хотите читать из именованных ветвлений кроме ветвей данных или ветвей ресурсов, или от файлов, больше, чем 2 ГБ, необходимо использовать FSReadFork функция или один из ее соответствующего параметра блокирует вызовы, PBReadForkSync и PBReadForkAsync. При попытке использовать FSRead для чтения из файла, больше, чем 2 ГБ, Вы получите сообщение об ошибке.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    FSWrite
    FSWrite

(OS X v10.4)

Записи любое число байтов к открытому файлу.

Оператор осуждения

Использовать FSWriteFork вместо этого.

Объявление

Objective C

OSErr FSWrite ( FSIORefNum refNum, SInt32 *count, const void *buffPtr );

Параметры

`refNum`	Число ссылки на файл открытого файла, в который можно записать.
`count`	На вводе, указателе на число байтов для записи в файл. Передача 0 в этом параметре возвратит a `paramErr` ошибка. На выводе, указателе на число байтов, фактически записанных.
`buffPtr`	Указатель на буфер данных, содержащий данные для записи.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

FSWrite функция берет конкретное количество байтов от буфера данных и пытается записать им в файл. Поскольку операция записи начинается в текущей метке, Вы могли бы хотеть установить метку сначала путем вызова SetFPos функция.

Если операция записи завершается успешно, FSWrite перемещает метку файла в байт после последнего записанного байта и возвраты noErr. При попытке записать мимо логического конца файла, FSWrite перемещает логический конец файла. При попытке записать мимо физического конца файла, FSWrite добавляют одна или более глыб к файлу и перемещают физический конец файла соответственно.

Низкоуровневые функции PBWriteSync и PBWriteAsync позвольте Вам установить метку, не имея необходимость вызывать SetFPos.

Если Вы хотите записать в именованные ветвления кроме ветвей данных или ветвей ресурсов, или увеличить файлы, больше, чем 2 ГБ, необходимо использовать FSWriteFork функция или один из ее соответствующего параметра блокирует вызовы, PBWriteForkSync и PBWriteForkAsync. При попытке использовать FSWrite для записи в файл, больше, чем 2 ГБ, Вы получите сообщение об ошибке.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    PBReadAsync
    PBReadAsync

(OS X v10.5)

Чтения любое число байтов от открытого файла.

Оператор осуждения

Использовать PBReadForkAsync вместо этого.

Объявление

Objective C

OSErr PBReadAsync ( ParmBlkPtr paramBlock );

Параметры


      paramBlock

Указатель на основной блок параметра Файлового менеджера.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения.
`ioResult`	На выводе, коде результата функции.
`ioRefNum`	На вводе, числе ссылки на файл для открытого файла, который будет считан.
`ioBuffer`	На вводе, указателе на буфер данных, в который читаются байты.
`ioReqCount`	На вводе требуют число байтов. Значение, которое Вы передаете в этом поле, должно быть больше, чем нуль.
`ioActCount`	На выводе фактически читало число байтов.
`ioPosMode`	На вводе, режиме расположения.
`ioPosOffset`	На вводе смещается расположение. На выводе, новой позиции метки.

Эта функция пытается читать ioReqCount байты от открытого файла, путь доступа которого указан в ioRefNum поле и передает их буферу данных, на который указывают ioBuffer поле. Позиция метки указана ioPosMode и ioPosOffset. Если Ваше приложение пытается читать мимо логического конца файла, PBReadAsync считывает данные, перемещает метку до конца файла и возвраты eofErr как его функциональный результат. Иначе, PBReadAsync перемещает метку файла в байт после последнего побайтового чтения и возвратов noErr.

Можно указать это PBReadAsync считайте данные файла 1 байт за один раз, пока требуемое число байтов не было считано или пока не достигнут конец файла. Для этого набор укусил 7 из ioPosMode поле. Точно так же можно указать это PBReadAsync должен прекратить считывать данные, когда они достигают определенного с помощью приложения символа новой строки. Для этого поместите код ASCII того символа в старший байт ioPosMode поле; необходимо также установить бит 7 из того поля для включения режима новой строки.

При чтении данных в режиме новой строки, PBReadAsync возвращает символ новой строки как часть чтения данных и наборов ioActCount к фактическому числу байтов, помещенных в буфер (который включает символ новой строки).

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.5.

Не доступный 64-разрядным приложениям.


    
    PBReadSync
    PBReadSync

(OS X v10.5)

Чтения любое число байтов от открытого файла.

Оператор осуждения

Использовать PBReadForkSync вместо этого.

Объявление

Objective C

OSErr PBReadSync ( ParmBlkPtr paramBlock );

Параметры


      paramBlock

Указатель на основной блок параметра Файлового менеджера.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioRefNum`	На вводе, числе ссылки на файл для открытого файла, который будет считан.
`ioBuffer`	На вводе, указателе на буфер данных, в который читаются байты.
`ioReqCount`	На вводе требуют число байтов. Значение, которое Вы передаете в этом поле, должно быть больше, чем нуль.
`ioActCount`	На выводе фактически читало число байтов.
`ioPosMode`	На вводе, режиме расположения.
`ioPosOffset`	На вводе смещается расположение. На выводе, новой позиции метки.

Эта функция пытается читать ioReqCount байты от открытого файла, путь доступа которого указан в ioRefNum поле и передает их буферу данных, на который указывают ioBuffer поле. Позиция метки указана ioPosMode и ioPosOffset. Если Ваше приложение пытается читать мимо логического конца файла, PBReadSync считывает данные, перемещает метку до конца файла и возвраты eofErr как его функциональный результат. Иначе, PBReadSync перемещает метку файла в байт после последнего побайтового чтения и возвратов noErr.

Можно указать это PBReadSync считайте данные файла 1 байт за один раз, пока требуемое число байтов не было считано или пока не достигнут конец файла. Для этого набор укусил 7 из ioPosMode поле. Точно так же можно указать это PBReadSync должен прекратить считывать данные, когда они достигают определенного с помощью приложения символа новой строки. Для этого поместите код ASCII того символа в старший байт ioPosMode поле; необходимо также установить бит 7 из того поля для включения режима новой строки.

При чтении данных в режиме новой строки, PBReadSync возвращает символ новой строки как часть чтения данных и наборов ioActCount к фактическому числу байтов, помещенных в буфер (который включает символ новой строки).

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.5.

Не доступный 64-разрядным приложениям.


    
    PBWriteAsync
    PBWriteAsync

(OS X v10.5)

Записи любое число байтов к открытому файлу.

Оператор осуждения

Использовать PBWriteForkAsync вместо этого.

Объявление

Objective C

OSErr PBWriteAsync ( ParmBlkPtr paramBlock );

Параметры


      paramBlock

Указатель на основной блок параметра Файлового менеджера.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения.
`ioResult`	На выводе, коде результата функции.
`ioRefNum`	На вводе, числе ссылки на файл для открытого файла, в который можно записать.
`ioBuffer`	На вводе, указателе на буфер данных, содержащий байты для записи.
`ioReqCount`	На вводе требуют число байтов.
`ioActCount`	На выводе, числе байтов, фактически записанных.
`ioPosMode`	На вводе, режиме расположения.
`ioPosOffset`	На вводе смещается расположение. На выводе, новой позиции метки.

PBWriteAsync функция берет ioReqCount байты от буфера, которым указывают ioBuffer и попытки записать им в открытый файл, путь доступа которого указан ioRefNum. Позиция метки указана ioPosMode и ioPosOffset. Если операция записи завершается успешно, PBWriteAsync перемещает метку файла в байт после последнего записанного байта и возвраты noErr. При попытке записать мимо логического конца файла, PBWriteAsync перемещает логический конец файла. При попытке записать мимо физического конца файла, PBWriteAsync добавляют одна или более глыб к файлу и перемещают физический конец файла соответственно.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.5.

Не доступный 64-разрядным приложениям.


    
    PBWriteSync
    PBWriteSync

(OS X v10.5)

Записи любое число байтов к открытому файлу.

Оператор осуждения

Использовать PBWriteForkSync вместо этого.

Объявление

Objective C

OSErr PBWriteSync ( ParmBlkPtr paramBlock );

Параметры


      paramBlock

Указатель на основной блок параметра Файлового менеджера.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioRefNum`	На вводе, числе ссылки на файл для открытого файла, в который можно записать.
`ioBuffer`	На вводе, указателе на буфер данных, содержащий байты для записи.
`ioReqCount`	На вводе требуют число байтов.
`ioActCount`	На выводе, числе байтов, фактически записанных.
`ioPosMode`	На вводе, режиме расположения.
`ioPosOffset`	На вводе смещается расположение. На выводе, новой позиции метки.

PBWriteSync функция берет ioReqCount байты от буфера, которым указывают ioBuffer и попытки записать им в открытый файл, путь доступа которого указан ioRefNum. Позиция метки указана ioPosMode и ioPosOffset. Если операция записи завершается успешно, PBWriteSync перемещает метку файла в байт после последнего записанного байта и возвраты noErr. При попытке записать мимо логического конца файла, PBWriteSync перемещает логический конец файла. При попытке записать мимо физического конца файла, PBWriteSync добавляют одна или более глыб к файлу и перемещают физический конец файла соответственно.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.5.

Не доступный 64-разрядным приложениям.

Разрешение ссылок идентификатора файла


    
    PBResolveFileIDRefSync
    PBResolveFileIDRefSync

(OS X v10.5)

Получает имя файла и родительский каталог ID файла, данного его идентификатор файла.

Оператор осуждения

Использовать FSGetCatalogInfo вместо этого.

Объявление

Objective C

OSErr PBResolveFileIDRefSync ( HParmBlkPtr paramBlock );

Параметры


      paramBlock

Указатель на FIDParam вариант блока параметра HFS. Посмотрите HParamBlockRec для получения дополнительной информации о HParamBlockRec тип данных.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера. Код возврата fidNotFound средние значения, что указанная ссылка идентификатора файла стала недопустимой, или потому что файл был удален или потому что ссылка идентификатора файла была уничтожена PBDeleteFileIDRefSync или PBDeleteFileIDRefAsync.

Обсуждение

Соответствующие поля блока параметра:

`ioNamePtr`	На вводе, указателе на путь. Если строка имени `NULL`, `PBResolveFileIDRefSync` самка s не возвращает имя файла, но возвращает только родительский каталог ID файла в `ioSrcDirID` поле. Если строка имени не `NULL` но только имя тома, `PBResolveFileIDRefSync` игнорирует значение в `ioVRefNum` поле и использование имя тома вместо этого. На выводе, указателе на имя файла файла с данным идентификатором файла.
`ioVRefNum`	На вводе, спецификации объема для объема, содержащего файл. Это поле может содержать ссылочный номер объема, число диска, или 0 для объема по умолчанию.
`ioSrcDirID`	На выводе, родительский каталог файла ID.
`ioFileID`	На вводе, идентификаторе файла для файла для получения информации о.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.5.

Не доступный 64-разрядным приложениям.


    
    PBResolveFileIDRefAsync
    PBResolveFileIDRefAsync

(OS X v10.5)

Получает имя файла и родительский каталог ID файла, данного его идентификатор файла.

Оператор осуждения

Использовать FSGetCatalogInfo вместо этого.

Объявление

Objective C

OSErr PBResolveFileIDRefAsync ( HParmBlkPtr paramBlock );

Параметры


      paramBlock

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции. Код возврата `fidNotFound` средние значения, что указанная ссылка идентификатора файла стала недопустимой, или потому что файл был удален или потому что ссылка идентификатора файла была уничтожена `PBDeleteFileIDRefSync` или `PBDeleteFileIDRefAsync`.
`ioNamePtr`	На вводе, указателе на путь. Если строка имени `NULL`, `PBResolveFileIDRefAsync` самка s не возвращает имя файла, но возвращает только родительский каталог ID файла в `ioSrcDirID` поле. Если строка имени не `NULL` но только имя тома, `PBResolveFileIDRefAsync` игнорирует значение в `ioVRefNum` поле и использование имя тома вместо этого. На выводе, указателе на имя файла для файла с данным идентификатором файла.
`ioVRefNum`	На вводе, спецификации объема для объема, содержащего файл. Это поле может содержать ссылочный номер объема, число диска, или 0 для объема по умолчанию.
`ioSrcDirID`	На выводе, родительский каталог файла ID.
`ioFileID`	На вводе, идентификаторе файла для файла для получения информации о.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.5.

Не доступный 64-разрядным приложениям.

Поиск объема


    
    PBCatSearchSync
    PBCatSearchSync

(OS X v10.4)

Ищет файл каталога объема с помощью ряда критериев поиска, которые Вы указываете.

Оператор осуждения

Использовать PBCatalogSearchSync вместо этого.

Объявление

Objective C

OSErr PBCatSearchSync ( CSParamPtr paramBlock );

Параметры


      paramBlock

Указатель на a CSParam вариант блока параметра HFS. Посмотрите HParamBlockRec для описания HParamBlockRec тип данных.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера. Когда PBCatSearchSync искал весь объем, он возвращается eofErr. Если это выходит, потому что это, любой проводит максимальное время, позволило войти ioSearchTime поле или находит, что максимальное количество соответствий позволило войти ioReqMatchCount поле, это возвращается noErr.

Обсуждение

Соответствующие поля блока параметра:

`ioNamePtr`	На вводе, указателе на имя объема для поиска.
`ioVRefNum`	На вводе, ссылочном номере объема или числе диска для объема для поиска; или 0 для объема по умолчанию.
`ioMatchPtr`	На вводе, указателе на массив `FSSpec` структура для содержания соответствий, найденных этой функцией. По возврату, `FSSpec` структуры в этом массиве идентифицируют файлы и каталоги, соответствующие критерии.
`ioReqMatchCount`	На вводе, максимальном количестве соответствий для возврата.
`ioActMatchCount`	На выводе возвратилось фактическое число соответствий.
`ioSearchBits`	На вводе, битовый массив, указывающий поля в структурах критериев для соответствия против. Посмотрите Маски Поиска Каталога для описания битов в этом поле.
`ioSearchInfo1`	На вводе, указателе на a `CInfoPBRec` объединение, содержащее поисковую информацию. Для значений, соответствующих маской и значением (Информация о средстве поиска, например), устанавливают биты в структуре, переданной в `ioSearchInfo2`, и набор совпадающее значение в этой структуре. Для значений, соответствующих против диапазона (такого как даты), установите нижние границы для диапазона в этой структуре.
`ioSearchInfo2`	На вводе, указателе на a `CInfoPBRec` объединение, содержащее поисковую информацию. Для значений, соответствующих маской и значением (Информация о средстве поиска, например), устанавливают биты в этой структуре и устанавливают совпадающее значение в структуре, переданной в `ioSearchInfo1` поле. Для значений, соответствующих против диапазона (такого как даты), установите верхние границы для диапазона в этой структуре.
`ioSearchTime`	На вводе, максимальное позволенное время поиска. Если Вы передаете 0 в этом поле, никакое ограничение по времени не установлено.
`ioCatPosition`	Текущая позиция каталога, указанная как a `CatPositionRec` структура. Можно использовать это поле, вместе с `ioSearchTime` поле, для поиска объема в сегментах. Для поиска объема в сегментах установите ограничение по времени для поиска в `ioSearchTime` поле и набор `initialize` поле `CatPositionRec` структура к расположению для запуска поиска (0, если Вы хотите начать искать в начале объема). По возврату будет обновлена позиция каталога. Можно тогда передать, это обновило `CatPositionRec` структура к следующему вызову к `PBCatSearchSync` продолжать искать в месте, где Вы кончили.
`ioOptBuffer`	На вводе, указателе на дополнительный буфер чтения.
`ioOptBufSize`	На вводе, длине дополнительного буфера чтения.

Если файл каталога изменяется между двумя синхронизированными вызовами на PBCatSearchSync (т.е. когда Вы используете ioSearchTime и ioCatPosition искать объем в сегментах и файле каталога изменяется между поисками), PBCatSearchSync возвращает код результата catChangedErr и никакие соответствия. В зависимости от какого изменилось на объеме, ioCatPosition могло бы быть недопустимым, наиболее вероятно несколькими записями в одном направлении или другом. Можно продолжать поиск, но Вы рискуете или пропускающий некоторые записи или читающий некоторых дважды.

Специальные замечания

Не все объемы поддерживают PBCatSearchSync функция. Перед вызовом PBCatSearchSync для поиска определенного объема необходимо вызвать PBHGetVolParmsSync функция, чтобы определить, поддерживает ли тот объем PBCatSearchSync.If bHasCatSearch бит установлен в vMAttrib поле, тогда поддержки объема PBCatSearchSync.

Даже при том, что объемы AFP поддерживают PBCatSearchSync, они не поддерживают все его функции, которые доступны на локальных томах. Эти ограничения применяются к объемам AFP:

Объемы AFP не используют ioSearchTime поле. Текущие версии программного обеспечения сервера AppleShare ищут 1 секунду или пока не найдены 4 соответствия. Программное обеспечение рабочей станции AppleShare продолжает запрашивать надлежащее число соответствий, пока сервер не возвращает ни одного число, указанное в ioReqMatchCount поле или ошибка.
Объемы AFP не поддерживают и логические и физические продолжительности ветвления. Если Вы запрашиваете поиск с помощью продолжительности ветвления, фактическая минимальная используемая длина является наименьшей из значений в логических и физических полях ioSearchInfo1 структура и фактическая максимальная используемая длина являются самыми большими из значений в логических и физических полях ioSearchInfo2 структура.
fsSBNegate бит ioSearchBits поле проигнорировано во время поисков удаленных объемов та поддержка версия 2.1 AFP.
Если возвращается сервер AFP afpCatalogChanged, структура позиции каталога возвратилась к Вашему приложению (в ioCatPosition поле), тот же самый, Вы передали PBCatSearchSync. Необходимо очиститься initialize поле той структуры для перезапуска поиска с начала.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    PBCatSearchAsync
    PBCatSearchAsync

(OS X v10.4)

Ищет файл каталога объема с помощью ряда критериев поиска, которые Вы указываете.

Оператор осуждения

Использовать PBCatalogSearchAsync вместо этого.

Объявление

Objective C

OSErr PBCatSearchAsync ( CSParamPtr paramBlock );

Параметры


      paramBlock

Указатель на a CSParam вариант блока параметра HFS. Посмотрите HParamBlockRec для описания HParamBlockRec тип данных.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции. Когда `PBCatSearchAsync` искал весь объем, он возвращается `eofErr`. Если это выходит, потому что это, любой проводит максимальное время, позволило войти `ioSearchTime` поле или находит, что максимальное количество соответствий позволило войти `ioReqMatchCount` поле, это возвращается `noErr`.
`ioNamePtr`	На вводе, указателе на имя объема для поиска.
`ioVRefNum`	На вводе, ссылочном номере объема или числе диска для объема для поиска; или 0 для объема по умолчанию.
`ioMatchPtr`	На вводе, указателе на массив `FSSpec` структура для содержания соответствий, найденных этой функцией. По возврату, `FSSpec` структуры в этом массиве идентифицируют файлы и каталоги, соответствующие критерии.
`ioReqMatchCount`	На вводе, максимальном количестве соответствий для возврата.
`ioActMatchCount`	На выводе возвратилось фактическое число соответствий.
`ioSearchBits`	На вводе, битовый массив, указывающий поля в структурах критериев для соответствия против. Посмотрите Маски Поиска Каталога для описания битов в этом поле.
`ioSearchInfo1`	На вводе, указателе на a `CInfoPBRec` объединение, содержащее поисковую информацию. Для значений, соответствующих маской и значением (Информация о средстве поиска, например), устанавливают биты в структуре, переданной в `ioSearchInfo2`, и набор совпадающее значение в этой структуре. Для значений, соответствующих против диапазона (такого как даты), установите нижние границы для диапазона в этой структуре.
`ioSearchInfo2`	На вводе, указателе на a `CInfoPBRec` объединение, содержащее поисковую информацию. Для значений, соответствующих маской и значением (Информация о средстве поиска, например), устанавливают биты в этой структуре и устанавливают совпадающее значение в структуре, переданной в `ioSearchInfo1` поле. Для значений, соответствующих против диапазона (такого как даты), установите верхние границы для диапазона в этой структуре.
`ioSearchTime`	На вводе, максимальное позволенное время поиска. Если Вы передаете 0 в этом поле, никакое ограничение по времени не установлено.
`ioCatPosition`	Текущая позиция каталога, указанная как a `CatPositionRec` структура. Можно использовать это поле, вместе с `ioSearchTime` поле, для поиска объема в сегментах. Для поиска объема в сегментах установите ограничение по времени для поиска в `ioSearchTime` поле и набор `initialize` поле `CatPositionRec` структура к расположению для запуска поиска (0, если Вы хотите начать искать в начале объема). По возврату будет обновлена позиция каталога. Можно тогда передать, это обновило `CatPositionRec` структура к следующему вызову к `PBCatSearchSync` продолжать искать в месте, где Вы кончили.
`ioOptBuffer`	На вводе, указателе на дополнительный буфер чтения.
`ioOptBufSize`	На вводе, длине дополнительного буфера чтения.

Если файл каталога изменяется между двумя синхронизированными вызовами на PBCatSearchAsync (т.е. когда Вы используете ioSearchTime и ioCatPosition искать объем в сегментах и файле каталога изменяется между поисками), PBCatSearchAsync возвращает код результата catChangedErr и никакие соответствия. В зависимости от какого изменилось на объеме, ioCatPosition могло бы быть недопустимым, наиболее вероятно несколькими записями в одном направлении или другом. Можно продолжать поиск, но Вы рискуете или пропускающий некоторые записи или читающий некоторых дважды.

Специальные замечания

Не все объемы поддерживают PBCatSearchAsync функция. Перед вызовом PBCatSearchAsync для поиска определенного объема необходимо вызвать PBHGetVolParmsAsync функция, чтобы определить, поддерживает ли тот объем PBCatSearchAsync. Если bHasCatSearch бит установлен в vMAttrib поле, тогда поддержки объема PBCatSearchAsync.

Объемы AFP не используют ioSearchTime поле. Текущие версии программного обеспечения сервера AppleShare ищут 1 секунду или пока не найдены 4 соответствия. Программное обеспечение рабочей станции AppleShare продолжает запрашивать надлежащее число соответствий, пока сервер не возвращает ни одного число, указанное в ioReqMatchCount поле или ошибка.
Объемы AFP не поддерживают и логические и физические продолжительности ветвления. Если Вы запрашиваете поиск с помощью продолжительности ветвления, фактическая минимальная используемая длина является наименьшей из значений в логических и физических полях ioSearchInfo1 структура и фактическая максимальная используемая длина являются самыми большими из значений в логических и физических полях ioSearchInfo2 структура.
fsSBNegate бит ioSearchBits поле проигнорировано во время поисков удаленных объемов та поддержка версия 2.1 AFP.
Если возвращается сервер AFP afpCatalogChanged, структура позиции каталога возвратилась к Вашему приложению (в ioCatPosition поле), тот же самый, Вы передали PBCatSearchAsync. Необходимо очиститься initialize поле той структуры для перезапуска поиска с начала.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.

Поиск объема Используя итератор каталога


    
    FSOpenIterator
    FSOpenIterator

(OS X v10.8)

Создает итератор каталога, который может использоваться для итерации по содержанию каталога или объема.

Оператор осуждения

Объявление

Objective C

OSErr FSOpenIterator ( const FSRef *container, FSIteratorFlags iteratorFlags, FSIterator *iterator );

Параметры

`container`	Указатель на `FSRef` для каталога для итерации. Набор элементов для итерации может или быть объектами, непосредственно содержавшимися в каталоге или всех элементах, прямо или косвенно содержавшихся в каталоге (когда, указанный каталог является корнем поддерева для итерации). Посмотрите `FSRef` для описания `FSRef` тип данных.
`iteratorFlags`	Ряд отмечает, который управляет, выполняет ли итератор итерации по поддеревьям или просто непосредственным дочерним элементам контейнера. Посмотрите Флаги Итератора для описания флагов, определенных для этого параметра. Итерация по поддеревьям, не происходящим в корневом каталоге объема, в настоящее время не поддерживается, и передача `kFSIterateSubtree` флаг в этом параметре возвраты `errFSBadIteratorFlags`. Чтобы определить, поддерживаются ли итераторы поддерева, проверьте что `bSupportsSubtreeIterators` бит, возвращенный `PBHGetVolParmsSync` или `PBHGetVolParmsAsync` установлен.
`iterator`	По возврату, указателю на новое `FSIterator`. Можно передать этот итератор `FSGetCatalogInfoBulk` или `FSCatalogSearch` функции и их параметр основанные на блоке дубликаты. Итератор автоматически инициализируется так, чтобы следующее использование итератора возвратило первый элемент. Порядок, в котором возвращаются элементы, является объемом, форматируют зависимого и может отличаться для двух различных итераторов, создаваемых с тем же контейнером и флагами. Посмотрите `FSIterator` для описания `FSIterator` тип данных.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Итераторы каталога должны быть закрыты, когда Вы сделаны с помощью них, выполнили ли Вы итерации по всем элементам. Итераторы автоматически закрываются после завершения процесса, точно так же, как открытые файлы. Однако необходимо использовать FSCloseIterator функция или один из связанного параметра блокирует функции, PBCloseIteratorSync и PBCloseIteratorAsync , закрыть итератор для высвобождения любых системных ресурсов, выделенных итератору.

Прежде, чем вызвать эту функцию, необходимо проверить, что она присутствует путем вызова Gestalt функция.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    PBOpenIteratorSync
    PBOpenIteratorSync

(OS X v10.8)

Создает итератор каталога, который может использоваться для итерации по содержанию каталога или объема.

Оператор осуждения

Объявление

Objective C

OSErr PBOpenIteratorSync ( FSCatalogBulkParam *paramBlock );

Параметры


      paramBlock

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`iterator`	На выводе, новом `FSIterator`. Можно передать этот итератор `FSGetCatalogInfoBulk` или `FSCatalogSearch` функции и их параметр основанные на блоке дубликаты. Итератор автоматически инициализируется так, чтобы следующее использование итератора возвратило первый элемент. Порядок, в котором возвращаются элементы, является объемом, форматируют зависимого и может отличаться для двух различных итераторов, создаваемых с тем же контейнером и флагами.
`iteratorFlags`	На вводе ряд отмечает, который управляет, выполняет ли итератор итерации по поддеревьям или просто непосредственным дочерним элементам контейнера. Посмотрите Флаги Итератора для описания флагов, определенных для этого поля. Итерация по поддеревьям, не происходящим в корневом каталоге объема, в настоящее время не поддерживается, и передача `kFSIterateSubtree` флаг в этом поле возвраты `errFSBadIteratorFlags`. Чтобы определить, поддерживаются ли итераторы поддерева, проверьте что `bSupportsSubtreeIterators` бит, возвращенный `PBHGetVolParmsSync` установлен.
`container`	На вводе, указателе на `FSRef` для каталога для итерации. Набор элементов для итерации может или быть объектами, непосредственно содержавшимися в каталоге или всех элементах, прямо или косвенно содержавшихся в каталоге (когда, указанный каталог является корнем поддерева для итерации).

Прежде, чем вызвать эту функцию, необходимо проверить, что она присутствует путем вызова Gestalt функция.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    PBOpenIteratorAsync
    PBOpenIteratorAsync

(OS X v10.8)

Создает итератор каталога, который может использоваться для итерации по содержанию каталога или объема.

Оператор осуждения

Объявление

Objective C

void PBOpenIteratorAsync ( FSCatalogBulkParam *paramBlock );

Параметры


      paramBlock

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции.
`iterator`	На выводе, новом `FSIterator`. Можно передать этот итератор `FSGetCatalogInfoBulk` или `FSCatalogSearch` функции и их параметр основанные на блоке дубликаты. Итератор автоматически инициализируется так, чтобы следующее использование итератора возвратило первый элемент. Порядок, в котором возвращаются элементы, является объемом, форматируют зависимого и может отличаться для двух различных итераторов, создаваемых с тем же контейнером и флагами.
`iteratorFlags`	На вводе ряд отмечает, который управляет, выполняет ли итератор итерации по поддеревьям или просто непосредственным дочерним элементам контейнера. Посмотрите Флаги Итератора для описания флагов, определенных для этого поля. Итерация по поддеревьям, не происходящим в корневом каталоге объема, в настоящее время не поддерживается, и передача `kFSIterateSubtree` флаг в этом поле возвраты `errFSBadIteratorFlags`. Чтобы определить, поддерживаются ли итераторы поддерева, проверьте что `bSupportsSubtreeIterators` бит, возвращенный `PBHGetVolParmsAsync` установлен.
`container`	На вводе, указателе на `FSRef` для каталога для итерации. Набор элементов для итерации может или быть объектами, непосредственно содержавшимися в каталоге или всех элементах, прямо или косвенно содержавшихся в каталоге (когда, указанный каталог является корнем поддерева для итерации).

Прежде, чем вызвать эту функцию, необходимо проверить, что она присутствует путем вызова Gestalt функция.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    FSCatalogSearch
    FSCatalogSearch

(OS X v10.8)

Поиски возражают пересеченный итератором каталога, которые соответствуют данный набор критериев.

Оператор осуждения

Используйте Центр внимания APIs вместо этого; для узнавания больше см. Обзор Центра внимания.

Объявление

Objective C

OSErr FSCatalogSearch ( FSIterator iterator, const FSSearchParams *searchCriteria, ItemCount maximumObjects, ItemCount *actualObjects, Boolean *containerChanged, FSCatalogInfoBitmap whichInfo, FSCatalogInfo *catalogInfos, FSRef *refs, FSSpecPtr specs, HFSUniStr255 *names );

Параметры

`iterator`	Итератор для использования. Объекты, пересеченные этим итератором, являются соответствующими против критериев, указанных `searchCriteria` параметр. Можно получить итератор каталога с функцией `FSOpenIterator`, или с одним из связанного параметра блокируют вызовы, `PBOpenIteratorSync` и `PBOpenIteratorAsync`. В настоящее время этот итератор должен быть создан с `kFSIterateSubtree` опция и контейнер должны быть корневым каталогом объема. Посмотрите `FSIterator` для получения дополнительной информации о `FSIterator` тип данных.
`searchCriteria`	Указатель на структуру, содержащую критерии поиска. Можно соответствовать против имени объекта в Unicode и полями в `FSCatalogInfo` структура. Можно использовать те же поисковые биты, как передано в `ioSearchBits` поле к `PBCatSearchSync` и `PBCatSearchAsync` функции; они управляют соответствием `FSCatalogInfo` поля. Посмотрите Маски Поиска Каталога для описания поисковых битов. Существует несколько новых критериев поиска, поддерживаемых `FSCatalogSearch` но не `PBCatSearchSync` и `PBCatSearchAsync`. Эти новые критерии поиска обозначены константами, описанными в Константах Поиска Каталога. Если `searchTime` поле этой структуры является ненулевым, это интерпретируется как продолжительность Тайм менеджера; поиск может завершиться после этой продолжительности даже если `maximumObjects` объекты не были возвращены, и весь каталог не был отсканирован. Если `searchTime` нуль, нет никакого ограничения по времени для поиска. Если Вы ищете по каким-либо критериям кроме имени, необходимо установить `searchInfo1` и `searchInfo2` поля структуры в этом параметре для указания на `FSCatalogInfo` структуры, содержащие значения для соответствия против. Посмотрите `FSSearchParams` для описания `FSSearchParams` тип данных.
`maximumObjects`	Максимальное количество элементов для возврата для этого вызова.
`actualObjects`	По возврату указатель на фактическое число элементов найден для этого вызова.
`containerChanged`	По возврату, указателю на булево значение, указывающее, изменилось ли содержание контейнера. Если `true`, содержание контейнера изменилось начиная с предыдущего `FSCatalogSearch` вызвать. Объекты могут все еще быть возвращены даже при том, что изменился контейнер. Обратите внимание на то, что, если контейнер изменился, то общий набор элементов возвратился, может быть неправильным; некоторые элементы могут быть возвращены многократно, и некоторые элементы не могут быть возвращены вообще. Если Вы не хотите эту информацию, передаете a, этот параметр является дополнительным `NULL` указатель.
`whichInfo`	Битовый массив, указывающий поля информации о каталоге для возврата для каждого элемента. Если Вам не жаль, что любая информация о каталоге не возвратилась, передайте константу `kFSCatInfoNone` в этом параметре. Посмотрите Растровые Константы информации о Каталоге для описания битов в этом параметре.
`catalogInfos`	Указатель на массив информационных структур каталога; один для каждого найденного элемента. На вводе, `catalogInfos` параметр должен указать на массив `maximumObjects` информационные структуры каталога. Этот параметр является дополнительным; если Вам не жаль, что любая информация о каталоге не возвратилась, передача `NULL` здесь. Посмотрите `FSCatalogInfo` для описания `FSCatalogInfo` тип данных.
`refs`	Указатель на массив `FSRef` структуры; один для каждого возвращенного элемента. Если Вы хотите `FSRef` для каждого найденного элемента, устанавливает этот параметр для указания на массив `maximumObjectsFSRef` структуры. Иначе, установите его в `NULL`. Посмотрите `FSRef` для описания `FSRef` тип данных.
`specs`
`names`	Указатель на массив имен файлов; один для каждого возвращенного элемента. Если Вы хотите имя файла Unicode для каждого найденного элемента, устанавливаете этот параметр для указания на массив `maximumObjectsHFSUniStr255` структуры. Иначе, установите его в `NULL`. Посмотрите `HFSUniStr255` для описания `HFSUniStr255` тип данных.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера. Когда весь объем искался, errFSNoMoreItems возвращается.

Обсуждение

Единственный поиск может охватить больше чем один вызов к FSCatalogSearch. Май вызова вместе ни с какой ошибкой прежде, чем отсканировать весь объем. Это обычно происходит потому что ограничение по времени ( searchTime) был достигнут или maximumObjects элементы были возвращены. Если поиск не завершается, можно продолжать поиск путем совершения другого звонка к FSCatalogSearch и передача обновленного итератора, возвращенного предыдущим вызовом в iterator параметр.

Прежде, чем вызвать эту функцию, необходимо решить, что она присутствует путем вызова Gestalt функция.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    PBCatalogSearchSync
    PBCatalogSearchSync

(OS X v10.8)

Поиски возражают пересеченный итератором каталога, которые соответствуют данный набор критериев.

Оператор осуждения

Используйте Центр внимания APIs вместо этого; для узнавания больше см. Обзор Центра внимания.

Объявление

Objective C

OSErr PBCatalogSearchSync ( FSCatalogBulkParam *paramBlock );

Параметры


      paramBlock

Возвращаемое значение

Обсуждение

Соответствующие поля этого параметра:

`iterator`	На вводе, итератор для использования. Объекты, пересеченные этим итератором, являются соответствующими против критериев, указанных `searchParams` поле. Можно получить итератор каталога с функцией `FSOpenIterator` , или с одним из связанного параметра блокируют вызовы, `PBOpenIteratorSync` и `PBOpenIteratorAsync`. В настоящее время этот итератор должен быть создан с `kFSIterateSubtree` опция и контейнер должны быть корневым каталогом объема. Посмотрите `FSIterator` для получения дополнительной информации о `FSIterator` тип данных.
`searchParams`	На вводе, указателе на `FSSearchParams` структура, содержащая критерии поиска. Можно соответствовать против имени объекта в Unicode и полями в `FSCatalogInfo` структура. Можно использовать те же поисковые биты, как передано в `ioSearchBits` поле к `PBCatSearchSync` и `PBCatSearchAsync` функции; они управляют соответствием `FSCatalogInfo` поля. Посмотрите Маски Поиска Каталога для описания поисковых битов. Существует несколько новых критериев поиска, поддерживаемых `PBCatalogSearchSync` но не `PBCatSearchSync` и `PBCatSearchAsync`. Эти новые критерии поиска обозначены константами, описанными в Константах Поиска Каталога. Если `searchTime` поле этой структуры является ненулевым, это интерпретируется как продолжительность Тайм менеджера; поиск может завершиться после этой продолжительности даже если `maximumItems` объекты не были возвращены, и весь каталог не был отсканирован. Если `searchTime` нуль, нет никакого ограничения по времени для поиска. Если Вы ищете по каким-либо критериям кроме имени, необходимо установить `searchInfo1` и `searchInfo2` поля структуры в этом поле для указания на `FSCatalogInfo` структуры, содержащие значения для соответствия против.
`maximumItems`	На вводе, максимальном количестве элементов для возврата для этого вызова.
`actualItems`	На выводе фактическое число элементов возвратилось для этого вызова.
`containerChanged`	На выводе, булево значение, указывающее, изменилось ли содержание контейнера. Если `true`, содержание контейнера изменилось начиная с предыдущего `PBCatalogSearchSync` вызвать. Объекты могут все еще быть возвращены даже при том, что изменился контейнер. Обратите внимание на то, что, если контейнер изменился, то общий набор элементов возвратился, может быть неправильным; некоторые элементы могут быть возвращены многократно, и некоторые элементы не могут быть возвращены вообще.
`whichInfo`	На вводе, битовый массив, указывающий поля информации о каталоге для возврата для каждого элемента. Если Вам не жаль, что любая информация о каталоге не возвратилась, передайте константу `kFSCatInfoNone` в этом поле. Посмотрите Растровые Константы информации о Каталоге для описания битов в этом поле.
`catalogInfo`	На выводе, указателе на массив `FSCatalogInfo` структуры; один для каждого найденного элемента. На вводе, `catalogInfo` поле должно указать на массив `maximumItems` информационные структуры каталога. Это поле является дополнительным; если Вам не жаль, что любая информация о каталоге не возвратилась, передача `NULL` здесь.
`refs`	На выводе, указателе на массив `FSRef` структуры; один для каждого возвращенного элемента. На вводе, если Вы хотите `FSRef` для каждого найденного элемента передайте указатель на массив `maximumItems` `FSRef` структуры. Иначе, передача `NULL`.
`names`	На выводе, указателе на массив имен файлов; один для каждого возвращенного элемента. На вводе, если Вы хотите имя файла Unicode для каждого найденного элемента, передают указатель на массив `maximumItems` `HFSUniStr255` структуры. Иначе, передача `NULL`.

Единственный поиск может охватить больше чем один вызов к PBCatalogSearchSync. Май вызова вместе ни с какой ошибкой прежде, чем отсканировать весь объем. Это обычно происходит потому что ограничение по времени ( searchTime) был достигнут или maximumItems элементы были возвращены. Если поиск не завершается, можно продолжать поиск путем совершения другого звонка к PBCatalogSearchSync и передача обновленного итератора, возвращенного предыдущим вызовом в iterator поле.

Прежде, чем вызвать эту функцию, необходимо решить, что она присутствует путем вызова Gestalt функция.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    PBCatalogSearchAsync
    PBCatalogSearchAsync

(OS X v10.8)

Поиски возражают пересеченный итератором каталога, которые соответствуют данный набор критериев.

Оператор осуждения

Используйте Центр внимания APIs вместо этого; для узнавания больше см. Обзор Центра внимания.

Объявление

Objective C

void PBCatalogSearchAsync ( FSCatalogBulkParam *paramBlock );

Параметры


      paramBlock

Обсуждение

Соответствующие поля этого параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции. Когда весь объем искался, `errFSNoMoreItems` возвращается.
`iterator`	На вводе, итератор для использования. Объекты, пересеченные этим итератором, являются соответствующими против критериев, указанных `searchParams` поле. Можно получить итератор каталога с функцией `FSOpenIterator` , или с одним из связанного параметра блокируют вызовы, `PBOpenIteratorSync` и `PBOpenIteratorAsync`. В настоящее время этот итератор должен быть создан с `kFSIterateSubtree` опция и контейнер должны быть корневым каталогом объема. Посмотрите `FSIterator` для получения дополнительной информации о `FSIterator` тип данных.
`searchParams`	На вводе, указателе на `FSSearchParams` структура, содержащая критерии поиска. Можно соответствовать против имени объекта в Unicode и полями в `FSCatalogInfo` структура. Можно использовать те же поисковые биты, как передано в `ioSearchBits` поле к `PBCatSearchSync` и `PBCatSearchAsync` функции; они управляют соответствием `FSCatalogInfo` поля. Посмотрите Маски Поиска Каталога для описания поисковых битов. Существует несколько новых критериев поиска, поддерживаемых `PBCatalogSearchAsync` но не `PBCatSearchSync` и `PBCatSearchAsync`. Эти новые критерии поиска обозначены константами, описанными в Константах Поиска Каталога. Если `searchTime` поле этой структуры является ненулевым, это интерпретируется как продолжительность Тайм менеджера; поиск может завершиться после этой продолжительности даже если `maximumItems` объекты не были возвращены, и весь каталог не был отсканирован. Если `searchTime` нуль, нет никакого ограничения по времени для поиска. Если Вы ищете по каким-либо критериям кроме имени, необходимо установить `searchInfo1` и `searchInfo2` поля структуры в этом поле для указания на `FSCatalogInfo` структуры, содержащие значения для соответствия против.
`maximumItems`	На вводе, максимальном количестве элементов для возврата для этого вызова.
`actualItems`	На выводе фактическое число элементов возвратилось для этого вызова.
`containerChanged`	На выводе, булево значение, указывающее, изменилось ли содержание контейнера. Если `true`, содержание контейнера изменилось начиная с предыдущего `PBCatalogSearchAsync` вызвать. Объекты могут все еще быть возвращены даже при том, что изменился контейнер. Обратите внимание на то, что, если контейнер изменился, то общий набор элементов возвратился, может быть неправильным; некоторые элементы могут быть возвращены многократно, и некоторые элементы не могут быть возвращены вообще.
`whichInfo`	На вводе, битовый массив, указывающий поля информации о каталоге для возврата для каждого элемента. Если Вам не жаль, что любая информация о каталоге не возвратилась, передайте константу `kFSCatInfoNone` в этом поле. Посмотрите Растровые Константы информации о Каталоге для описания битов в этом поле.
`catalogInfo`	На выводе, указателе на массив `FSCatalogInfo` структуры; один для каждого найденного элемента. На вводе, `catalogInfo` поле должно указать на массив `maximumItems` информационные структуры каталога. Это поле является дополнительным; если Вам не жаль, что любая информация о каталоге не возвратилась, передача `NULL` здесь.
`refs`	На выводе, указателе на массив `FSRef` структуры; один для каждого возвращенного элемента. На вводе, если Вы хотите `FSRef` для каждого найденного элемента передайте указатель на массив `maximumItems` `FSRef` структуры. Иначе, передача `NULL`.
`names`	На выводе, указателе на массив имен файлов; один для каждого возвращенного элемента. На вводе, если Вы хотите имя файла Unicode для каждого найденного элемента, передают указатель на массив `maximumItems` `HFSUniStr255` структуры. Иначе, передача `NULL`.

Единственный поиск может охватить больше чем один вызов к PBCatalogSearchAsync. Май вызова вместе ни с какой ошибкой прежде, чем отсканировать весь объем. Это обычно происходит потому что ограничение по времени ( searchTime) был достигнут или maximumItems элементы были возвращены. Если поиск не завершается, можно продолжать поиск путем совершения другого звонка к PBCatalogSearchAsync и передача обновленного итератора, возвращенного предыдущим вызовом в iterator поле.

Прежде, чем вызвать эту функцию, необходимо решить, что она присутствует путем вызова Gestalt функция.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    FSCloseIterator
    FSCloseIterator

(OS X v10.8)

Закрывает итератор каталога.

Оператор осуждения

Объявление

Objective C

OSErr FSCloseIterator ( FSIterator iterator );

Параметры


      iterator

Итератор каталога, который будет закрыт. FSCloseIterator память выпусков и другие системные ресурсы, используемые итератором, делая итератор недопустимым. Посмотрите FSIterator для описания FSIterator тип данных.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Эта функция выпускает память и другие системные ресурсы, используемые итератором. Итератор становится недопустимым.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    PBCloseIteratorSync
    PBCloseIteratorSync

(OS X v10.8)

Закрывает итератор каталога.

Оператор осуждения

Объявление

Objective C

OSErr PBCloseIteratorSync ( FSCatalogBulkParam *paramBlock );

Параметры


      paramBlock

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующее поле блока параметра:


      iterator

На вводе, итератор каталога для закрытия. PBCloseIteratorSync память выпусков и другие системные ресурсы, используемые итератором, делая итератор недопустимым. Посмотрите FSIterator для описания FSIterator тип данных.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    PBCloseIteratorAsync
    PBCloseIteratorAsync

(OS X v10.8)

Закрывает итератор каталога.

Оператор осуждения

Объявление

Objective C

void PBCloseIteratorAsync ( FSCatalogBulkParam *paramBlock );

Параметры


      paramBlock

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции.
`iterator`	На вводе, итератор каталога для закрытия. `PBCloseIteratorAsync` память выпусков и другие системные ресурсы, используемые итератором, делая итератор недопустимым. Посмотрите `FSIterator` для описания `FSIterator` тип данных.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.

Обновление файлов

FSFlushFork FSFlushFork (OS X v10.8)

Причины все данные, записанные в открытое ветвление, которое будет записано в диск.

Оператор осуждения

На уровне POSIX/BSD использовать fsync вместо этого. Для сбрасывания ветви данных на уровне Foundation использовать NSFileHandle APIs вместо этого.

Объявление

Objective C

OSErr FSFlushFork ( FSIORefNum forkRefNum );

Параметры

forkRefNum

Ссылочный номер ветвления для сбрасывания.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

FSFlushFork функционируйте заставляет фактическое содержание ветвления быть записанным в диск, а также любые другие структуры объема должны были получить доступ к ветвлению. На HFS и HFS Плюс, это включает каталог, степени и B-деревья атрибута; битовый массив объема; и заголовок объема и альтернативный заголовок объема (MDB и альтернативный MDB на объемах HFS), по мере необходимости.

На не поддерживающих объемах FSFlushFork непосредственно, весь объем сбрасывается, чтобы быть уверенным, что все структуры объема, связанные с ветвлением, записаны в диск.

Вы не делаете, должен использовать FSFlushFork сбросить ветвление файла, прежде чем это будет закрыто; файл автоматически сбрасывается, когда он закрывается, и все блоки данных кэша связаны с ним, удалены из кэша.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.8.


    
    PBFlushFileSync
    PBFlushFileSync

(OS X v10.4)

Пишет содержание буфера пути доступа файла к диску.

Оператор осуждения

Использовать PBFlushForkSync вместо этого.

Объявление

Objective C

OSErr PBFlushFileSync ( ParmBlkPtr paramBlock );

Параметры


      paramBlock

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующее поле блока параметра:


      ioRefNum

На вводе, числе ссылки на файл для файла для сбрасывания.

После записи содержания файла к объему, PBFlushFileSync функционируйте обновляет запись файла в каталоге объема.

В случае системного катастрофического отказа потеряны все кэшированные данные, еще не записанные в диск. При внесении изменений для интервала, это уже существует в файле (Вы перезаписываете существующие данные перед концом файла файла), необходимо использовать PBFlushFileSync гарантировать, что все записанное в файл будет записано в диск. Если Вы сбрасываете кэшируемое блочное использование ветвления PBFlushFileSync, единственная возможная потеря данных в системном катастрофическом отказе будет датой модификации файла.

Вы не должны, однако, использовать PBFlushFileSync сбросить ветвление файла, прежде чем это будет закрыто; файл автоматически сбрасывается, когда он закрывается, и все блоки данных кэша связаны с ним, удалены из кэша.

PBFlushFileSync сбрасывает грязные кэшируемые блоки открытого ветвления, но может не сбросить информацию о каталоге, связанную с файлом. Для сбрасывания информации о каталоге вызвать FlushVol , или один из связанного параметра блокирует вызовы, PBFlushVolSync и PBFlushVolAsync.

Для обновления файла, больше, чем 2 ГБ или именованного ветвления кроме ветвей данных и ветвей ресурсов, необходимо использовать FSFlushFork функция или один из соответствующего параметра блокирует вызовы, PBFlushForkSync и PBFlushForkAsync.

Специальные замечания

Некоторая информация, хранившая на объеме, не будет корректна до PBFlushVolSync вызывается.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    PBFlushFileAsync
    PBFlushFileAsync

(OS X v10.4)

Пишет содержание буфера пути доступа файла к диску.

Оператор осуждения

Использовать PBFlushForkAsync вместо этого.

Объявление

Objective C

OSErr PBFlushFileAsync ( ParmBlkPtr paramBlock );

Параметры


      paramBlock

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции.
`ioRefNum`	На вводе, числе ссылки на файл для файла для сбрасывания.

После записи содержания файла к объему, PBFlushFileAsync функционируйте обновляет запись файла в каталоге объема.

В случае системного катастрофического отказа потеряны все кэшированные данные, еще не записанные в диск. При внесении изменений для интервала, это уже существует в файле (Вы перезаписываете существующие данные перед концом файла файла), необходимо использовать PBFlushFileAsync гарантировать, что все записанное в файл будет записано в диск. Если Вы сбрасываете кэшируемое блочное использование ветвления PBFlushFileAsync, единственная возможная потеря данных в системном катастрофическом отказе будет датой модификации файла.

Вы не должны, однако, использовать PBFlushFileAsync сбросить ветвление файла, прежде чем это будет закрыто; файл автоматически сбрасывается, когда он закрывается, и все блоки данных кэша связаны с ним, удалены из кэша.

Специальные замечания

Некоторая информация, хранившая на объеме, не будет корректна до PBFlushVolAsync вызывается.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.4.

Не доступный 64-разрядным приложениям.


    
    PBFlushForkSync
    PBFlushForkSync

(OS X v10.8)

Причины все данные, записанные в открытое ветвление, которое будет записано в диск.

Оператор осуждения

На уровне POSIX/BSD использовать fsync вместо этого. Для сбрасывания ветви данных на уровне Foundation использовать NSFileHandle APIs вместо этого.

Объявление

Objective C

OSErr PBFlushForkSync ( FSForkIOParam *paramBlock );

Параметры


      paramBlock

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующее поле блока параметра:


      forkRefNum

На вводе, ссылочном номере ветвления для сбрасывания.

PBFlushForkSync функционируйте заставляет фактическое содержание ветвления быть записанным в диск, а также любые другие структуры объема должны были получить доступ к ветвлению. На HFS и HFS Плюс, это включает каталог, степени и B-деревья атрибута; битовый массив объема; и заголовок объема и альтернативный заголовок объема (MDB и альтернативный MDB на объемах HFS), по мере необходимости.

На не поддерживающих объемах PBFlushForkSync непосредственно, весь объем сбрасывается, чтобы быть уверенным, что все структуры объема, связанные с ветвлением, записаны в диск.

Вы не делаете, должен использовать PBFlushForkSync сбросить ветвление файла, прежде чем это будет закрыто; файл автоматически сбрасывается, когда он закрывается, и все блоки данных кэша связаны с ним, удалены из кэша.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    PBFlushForkAsync
    PBFlushForkAsync

(OS X v10.8)

Причины все данные, записанные в открытое ветвление, которое будет записано в диск.

Оператор осуждения

Объявление

Objective C

void PBFlushForkAsync ( FSForkIOParam *paramBlock );

Параметры


      paramBlock

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции.
`forkRefNum`	На вводе, ссылочном номере ветвления для сбрасывания.

PBFlushForkAsync функционируйте заставляет фактическое содержание ветвления быть записанным в диск, а также любые другие структуры объема должны были получить доступ к ветвлению. На HFS и HFS Плюс, это включает каталог, степени и B-деревья атрибута; битовый массив объема; и заголовок объема и альтернативный заголовок объема (MDB и альтернативный MDB на объемах HFS), по мере необходимости.

На не поддерживающих объемах PBFlushForkAsync непосредственно, весь объем сбрасывается, чтобы быть уверенным, что все структуры объема, связанные с ветвлением, записаны в диск.

Вы не делаете, должен использовать PBFlushForkAsync сбросить ветвление файла, прежде чем это будет закрыто; файл автоматически сбрасывается, когда он закрывается, и все блоки данных кэша связаны с ним, удалены из кэша.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.

Обновление объемов

FSFlushVolume FSFlushVolume (OS X v10.8)

Для указанного объема пишут все открытые и измененные файлы в текущем процессе к постоянному хранению.

Оператор осуждения

На уровне POSIX/BSD использовать sync_volume_np(3) вместо этого.

Объявление

Objective C

OSStatus FSFlushVolume ( FSVolumeRefNum vRefNum );

Параметры

vRefNum

Ссылочный номер объема объема для сбрасывания.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.8.


    
    PBFlushVolumeSync
    PBFlushVolumeSync

(OS X v10.8)

Для указанного объема пишут все открытые и измененные файлы в текущем процессе к постоянному хранению.

Оператор осуждения

На уровне POSIX/BSD использовать sync_volume_np(3) вместо этого.

Объявление

Objective C

OSStatus PBFlushVolumeSync ( FSRefParamPtr paramBlock );

Параметры


      paramBlock

Блок параметра, содержащий ссылочный номер объема объема для сбрасывания. Посмотрите FSRefParam.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.5 и позже.

Осуждаемый в OS X v10.8.


    
    PBFlushVolumeAsync
    PBFlushVolumeAsync

(OS X v10.8)

Для указанного объема пишут все открытые и измененные файлы в текущем процессе к постоянному хранению.

Оператор осуждения

На уровне POSIX/BSD использовать sync_volume_np(3) вместо этого.

Объявление

Objective C

OSStatus PBFlushVolumeAsync ( FSRefParamPtr paramBlock );

Параметры


      paramBlock

Блок параметра, содержащий ссылочный номер объема объема для сбрасывания. Посмотрите FSRefParam.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.5 и позже.

Осуждаемый в OS X v10.8.


    
    FlushVol
    FlushVol

(OS X v10.5)

Пишет содержание буфера объема и обновляет информацию об объеме.

Оператор осуждения

Использовать FSFlushVolume вместо этого.

Объявление

Objective C

OSErr FlushVol ( ConstStr63Param volName, FSVolumeRefNum vRefNum );

Параметры

`volName`	Имя смонтированного объема для сбрасывания.
`vRefNum`	Ссылочный номер объема, управляйте числом, или 0 для объема по умолчанию.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Для указанного объема, FlushVol функционируйте пишет содержание связанного объема буферную и дескриптивную информацию об объеме. Информация, изменившаяся с прошлого раза FlushVol был вызван записан в объем.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.5.

Не доступный 64-разрядным приложениям.


    
    PBFlushVolSync
    PBFlushVolSync

(OS X v10.5)

Пишет содержание буфера объема и обновляет информацию об объеме.

Оператор осуждения

Использовать PBFlushVolumeSync вместо этого.

Объявление

Objective C

OSErr PBFlushVolSync ( ParmBlkPtr paramBlock );

Параметры


      paramBlock

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioNamePtr`	На вводе, указателе на имя объема для сбрасывания.
`ioVRefNum`	На вводе, ссылочном номере объема, числе диска, или 0 для объема по умолчанию.

PBFlushVolSync сбросы все открытые файлы на объеме, и затем сбрасывают все структуры данных объема. На объеме, указанном ioNamePtr или ioVRefNum, PBFlushVolSync функционируйте пишет дескриптивная информация об объеме, содержании связанного буфера объема и всех буферов пути доступа для объема (если они изменились с прошлого раза PBFlushVolSync был вызван).

Дата и время последнего изменения к объему установлена, когда модификация сделана, не, когда сбрасывается объем.

Чтобы гарантировать, что все изменения в объеме сбрасываются к объему, использовать PBFlushVolSync. Вы не должны, однако, сбрасывать объем прежде, чем размонтировать его, извлекая его, или помещение его оффлайн; это сделано автоматически.

Если изменения внесены в файл, которые влияют на конец файла файла, имя файла, информацию о Средстве поиска файла или расположение файла на объеме, то необходимо использовать PBFlushVolSync, или один из других двух сбросов объема функционирует в этом разделе, чтобы гарантировать, что эти изменения записаны в диск.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.5.

Не доступный 64-разрядным приложениям.


    
    PBFlushVolAsync
    PBFlushVolAsync

(OS X v10.5)

Пишет содержание буфера объема и обновляет информацию об объеме.

Оператор осуждения

Использовать PBFlushVolumeAsync вместо этого.

Объявление

Objective C

OSErr PBFlushVolAsync ( ParmBlkPtr paramBlock );

Параметры


      paramBlock

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Соответствующие поля блока параметра:

`ioCompletion`	На вводе, указателе на подпрограмму завершения. Для получения дополнительной информации о подпрограммах завершения посмотрите `IOCompletionProcPtr`.
`ioResult`	На выводе, коде результата функции.
`ioNamePtr`	На вводе, указателе на имя объема для сбрасывания.
`ioVRefNum`	На вводе, ссылочном номере объема, числе диска, или 0 для объема по умолчанию.

PBFlushVolAsync сбросы все открытые файлы на объеме, и затем сбрасывают все структуры данных объема. На объеме, указанном ioNamePtr или ioVRefNum, PBFlushVolAsync функционируйте пишет дескриптивная информация об объеме, содержании связанного буфера объема и всех буферов пути доступа для объема (если они изменились с прошлого раза PBFlushVolAsync был вызван).

Чтобы гарантировать, что все изменения в объеме сбрасываются к объему, использовать PBFlushVolAsync. Вы не должны, однако, сбрасывать объем прежде, чем размонтировать его, извлекая его, или помещение его оффлайн; это сделано автоматически.

Если изменения внесены в файл, которые влияют на конец файла файла, имя файла, информацию о Средстве поиска файла или расположение файла на объеме, то необходимо использовать PBFlushVolAsync, или один из других двух сбросов объема функционирует в этом разделе, чтобы гарантировать, что эти изменения записаны в диск.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.5.

Не доступный 64-разрядным приложениям.

Используя уведомления изменения


    
    FNNotify
    FNNotify

(OS X v10.8)

Широковещательное уведомление об изменениях в указанном каталоге.

Оператор осуждения

Используйте События Файловой системы API вместо этого. Для получения дополнительной информации посмотрите Используя События Файловой системы API.

Объявление

Objective C

OSStatus FNNotify ( const FSRef *ref, FNMessage message, OptionBits flags );

Параметры

`ref`	Ссылочное описание файловой системы каталога, для которого можно широковещательно передать уведомление.
`message`	Индикация относительно того, что произошло с целевым каталогом.
`flags`	Опции относительно поставки уведомления. Указать `kNilOptions` для поведения по умолчанию.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    FNNotifyAll
    FNNotifyAll

(OS X v10.8)

Широковещательное уведомление об изменениях в файловой системе.

Оператор осуждения

Объявление

Objective C

OSStatus FNNotifyAll ( FNMessage message, OptionBits flags );

Параметры

`message`	Индикация относительно того, что произошло.
`flags`	Опции относительно поставки уведомления. Указать `kNilOptions` для поведения по умолчанию.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Эта функция должна только использоваться установщиками или программами, вносящими много изменений и только отправляющими широковещательную передачу того.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    FNNotifyByPath
    FNNotifyByPath

(OS X v10.8)

Широковещательное уведомление об изменениях в указанном каталоге.

Оператор осуждения

Объявление

Objective C

OSStatus FNNotifyByPath ( const UInt8 *path, FNMessage message, OptionBits flags );

Параметры

`path`	Путь к каталогу, для которого можно широковещательно передать уведомление.
`message`	Индикация относительно того, что произошло с целевым каталогом.
`flags`	Опции относительно поставки уведомления. Указать `kNilOptions` для поведения по умолчанию.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.8.


    
    FNSubscribe
    FNSubscribe

(OS X v10.8)

Подписывается для изменения уведомлений для указанного каталога.

Оператор осуждения

Объявление

Objective C

OSStatus FNSubscribe ( const FSRef *directoryRef, FNSubscriptionUPP callback, void *refcon, OptionBits flags, FNSubscriptionRef *subscription );

Параметры

`directoryRef`	Ссылочное описание файловой системы каталога, для которого вызывающая сторона хочет уведомления.
`callback`	Указатель на функцию для вызова, когда поступает уведомление.
`refcon`	Указатель на пользовательское состояние переносят с подпиской.
`flags`	Указать `kNilOptions`, или одна из опций описана в Опциях Подписки Уведомления.
`subscription`	Маркер подписки для последующего запроса или неподписки.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.1 и позже.

Осуждаемый в OS X v10.8.


    
    FNSubscribeByPath
    FNSubscribeByPath

(OS X v10.8)

Подписывается для изменения уведомлений для указанного каталога.

Оператор осуждения

Объявление

Objective C

OSStatus FNSubscribeByPath ( const UInt8 *directoryPath, FNSubscriptionUPP callback, void *refcon, OptionBits flags, FNSubscriptionRef *subscription );

Параметры

`directoryPath`	Путь к каталогу, для которого вызывающая сторона хочет уведомления.
`callback`	Функция для вызова, когда поступает уведомление.
`refcon`	Указатель на пользовательское состояние переносят с подпиской.
`flags`	Указать `kNilOptions`, или одна из опций описана в Опциях Подписки Уведомления.
`subscription`	Маркер подписки для последующего запроса или неподписки.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.1 и позже.

Осуждаемый в OS X v10.8.

FNUnsubscribe FNUnsubscribe (OS X v10.8)

Выпускает подписку, которая больше не необходима.

Объявление

Objective C

OSStatus FNUnsubscribe ( FNSubscriptionRef subscription );

Параметры

subscription

Подписка ранее возвратилась из FNSubscribe илиFNSubscribeByPath функции.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.1 и позже.
Осуждаемый в OS X v10.8.


    
    FNGetDirectoryForSubscription
    FNGetDirectoryForSubscription

(OS X v10.8)

Выбирает каталог, для которого первоначально вводилась эта подписка.

Оператор осуждения

Объявление

Objective C

OSStatus FNGetDirectoryForSubscription ( FNSubscriptionRef subscription, FSRef *ref );

Параметры

`subscription`	Подписка ранее возвратилась из функций `FNSubscribe` или `FNSubscribeByPath`.
`ref`	По возврату, ссылке файловой системы на каталог, для которого создавалась эта подписка.

Возвращаемое значение

Код результата. Посмотрите Коды Результата Файлового менеджера.

Обсуждение

Нет никакого варианта пути, потому что пути хрупки, и путь, возможно, изменился. Если вызывающая сторона не заботится об этой тонкости, она может вызвать FSRefMakePath получить путь от возвращенной ссылки.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.1 и позже.

Осуждаемый в OS X v10.8.

Не рекомендуемый

Этот раздел перечисляет функции, не рекомендующиеся, и Вы больше не должны использовать.

PBGetUGEntrySync PBGetUGEntrySync (OS X v10.4)

Получает пользователя или запись группы из списка Пользователя и Названий группы и IDs на локальном файловом сервере.

Оператор осуждения

Нет никакой заменяющей функции.

Объявление

Objective C

OSErr PBGetUGEntrySync ( HParmBlkPtr paramBlock );

Специальные замечания

Эта функция не реализована в OS X.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.4.
Не доступный 64-разрядным приложениям.
PBGetUGEntryAsync PBGetUGEntryAsync (OS X v10.4)

Получает пользователя или запись группы из списка Пользователя и Названий группы и IDs на локальном файловом сервере.

Оператор осуждения

Нет никакой заменяющей функции.

Объявление

Objective C

OSErr PBGetUGEntryAsync ( HParmBlkPtr paramBlock );

Специальные замечания

Эта функция не реализована в OS X.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.4.
Не доступный 64-разрядным приложениям.
PBShareSync PBShareSync (OS X v10.4)

Устанавливает локальный том или каталог как точка доли.

Оператор осуждения

Нет никакой заменяющей функции.

Объявление

Objective C

OSErr PBShareSync ( HParmBlkPtr paramBlock );

Специальные замечания

Эта функция не реализована в OS X.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.4.
Не доступный 64-разрядным приложениям.
PBShareAsync PBShareAsync (OS X v10.4)

Устанавливает локальный том или каталог как точка доли.

Оператор осуждения

Нет никакой заменяющей функции.

Объявление

Objective C

OSErr PBShareAsync ( HParmBlkPtr paramBlock );

Специальные замечания

Эта функция не реализована в OS X.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.4.
Не доступный 64-разрядным приложениям.
PBUnshareSync PBUnshareSync (OS X v10.4)

Высказывает мнение доли, недоступное в сети.

Оператор осуждения

Нет никакой заменяющей функции.

Объявление

Objective C

OSErr PBUnshareSync ( HParmBlkPtr paramBlock );

Специальные замечания

Эта функция не реализована в OS X.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.4.
Не доступный 64-разрядным приложениям.
PBUnshareAsync PBUnshareAsync (OS X v10.4)

Высказывает мнение доли, недоступное в сети.

Оператор осуждения

Нет никакой заменяющей функции.

Объявление

Objective C

OSErr PBUnshareAsync ( HParmBlkPtr paramBlock );

Специальные замечания

Эта функция не реализована в OS X.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.4.
Не доступный 64-разрядным приложениям.
PBGetForeignPrivsSync PBGetForeignPrivsSync (OS X v10.4)

Определяет собственную информацию о контроле доступа для файла или каталога, сохраненного на объеме, которым управляет внешняя файловая система.

Оператор осуждения

Нет никакой заменяющей функции.

Объявление

Objective C

OSErr PBGetForeignPrivsSync ( HParmBlkPtr paramBlock );

Специальные замечания

Эта функция не реализована в OS X.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.4.
Не доступный 64-разрядным приложениям.
PBGetForeignPrivsAsync PBGetForeignPrivsAsync (OS X v10.4)

Определяет собственную информацию о контроле доступа для файла или каталога, сохраненного на объеме, которым управляет внешняя файловая система.

Оператор осуждения

Нет никакой заменяющей функции.

Объявление

Objective C

OSErr PBGetForeignPrivsAsync ( HParmBlkPtr paramBlock );

Специальные замечания

Эта функция не реализована в OS X.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.4.
Не доступный 64-разрядным приложениям.
PBSetForeignPrivsSync PBSetForeignPrivsSync (OS X v10.4)

Изменяет собственную информацию о контроле доступа для файла или каталога, сохраненного на объеме, которым управляет внешняя файловая система.

Оператор осуждения

Нет никакой заменяющей функции.

Объявление

Objective C

OSErr PBSetForeignPrivsSync ( HParmBlkPtr paramBlock );

Специальные замечания

Эта функция не реализована в OS X.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.4.
Не доступный 64-разрядным приложениям.
PBSetForeignPrivsAsync PBSetForeignPrivsAsync (OS X v10.4)

Изменяет собственную информацию о контроле доступа для файла или каталога, сохраненного на объеме, которым управляет внешняя файловая система.

Оператор осуждения

Нет никакой заменяющей функции.

Объявление

Objective C

OSErr PBSetForeignPrivsAsync ( HParmBlkPtr paramBlock );

Специальные замечания

Эта функция не реализована в OS X.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.4.
Не доступный 64-разрядным приложениям.
PBHGetLogInInfoSync PBHGetLogInInfoSync (OS X v10.4)

Решает, что метод входа в систему раньше входил в систему определенного совместно используемого тома.

Оператор осуждения

Нет никакой заменяющей функции.

Объявление

Objective C

OSErr PBHGetLogInInfoSync ( HParmBlkPtr paramBlock );

Специальные замечания

Эта функция не реализована в OS X.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.4.
Не доступный 64-разрядным приложениям.
PBGetXCatInfoSync PBGetXCatInfoSync (OS X v10.4)

Возвращает краткое название (имя формата MS-DOS) и информация о ProDOS для файла или каталога.

Оператор осуждения

Нет никакой заменяющей функции.

Объявление

Objective C

OSErr PBGetXCatInfoSync ( XCInfoPBPtr paramBlock );

Специальные замечания

Эта функция не реализована в OS X.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.4.
Не доступный 64-разрядным приложениям.
PBGetXCatInfoAsync PBGetXCatInfoAsync (OS X v10.4)

Возвращает краткое название (имя формата MS-DOS) и информация о ProDOS для файла или каталога.

Оператор осуждения

Нет никакой заменяющей функции.

Объявление

Objective C

OSErr PBGetXCatInfoAsync ( XCInfoPBPtr paramBlock );

Специальные замечания

Эта функция не реализована в OS X.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.4.
Не доступный 64-разрядным приложениям.


    
    PBWaitIOComplete
    PBWaitIOComplete

(OS X v10.5)

Сохраняет систему неактивной, пока или прерывание не происходит или указанное значение тайм-аута, достигнут.

Оператор осуждения

Нет никакой заменяющей функции.

Объявление

Objective C

OSErr PBWaitIOComplete ( ParmBlkPtr paramBlock, Duration timeout );

Параметры

`paramBlock`	Указатель на основной блок параметра Файлового менеджера.
`timeout`	Максимальный отрезок времени Вы хотите, чтобы система была сохранена неактивной.

Возвращаемое значение

Код результата. Если значение тайм-аута достигнуто, возвраты kMPTimeoutErr.

Специальные замечания

Эта функция не реализована в OS X.

Оператор импорта

Objective C

@import CoreServices;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.5.

Не доступный 64-разрядным приложениям.

Обратные вызовы

Обратные вызовы работы файла


    
    FSFileOperationStatusProcPtr
    FSFileOperationStatusProcPtr

Определяет функцию обратного вызова состояния для асинхронной работы файла на FSRef объект.

Объявление

Swift

typealias FSFileOperationStatusProcPtr = CFunctionPointer<((FSFileOperation!, UnsafePointer<FSRef>, FSFileOperationStage, OSStatus, CFDictionary!, UnsafeMutablePointer<Void>) -> Void)>

Objective C

typedef void (*FSFileOperationStatusProcPtr) ( FSFileOperationRef fileOp, const FSRef *currentItem, FSFileOperationStage stage, OSStatus error, CFDictionaryRef statusDictionary, void *info );

Параметры

`fileOp`	Работа файла.
`currentItem`	Указатель на `FSRef` переменная. На выводе переменная содержит объект, в настоящее время перемещаемый или скопированный. Если работа завершена, этот параметр относится к цели (новый объект, соответствующий исходному объекту в целевом каталоге).
`stage`	Текущий этап работы.
`error`	Текущее ошибочное состояние работы.
`statusDictionary`	Словарь с более подробной информацией о статусе. Для получения информации о содержании словаря посмотрите `“File Operation Status Dictionary Keys”`. Вы не ответственны за выпуск словаря.
`info`	Указатель на определяемые пользователем данные связался с этой работой.

Обсуждение

Когда Вы вызываете FSCopyObjectAsync, FSMoveObjectAsync, или FSMoveObjectToTrashAsync, можно указать функцию обратного вызова состояния этого типа. Функция, которую Вы обеспечиваете, вызвана Файловым менеджером каждый раз, когда этапы изменений работы файла (включая сбой вследствие ошибки), или поскольку обновленная информация доступна ограниченный интервалом изменения состояния работы. Если необходимо сохранить какую-либо информацию о статусе вне объема обратного вызова, необходимо сделать копию информации.

Оператор импорта

Objective C

@import CoreServices;

Swift

import CoreServices

Доступность

Доступный в OS X v10.4 и позже.


    
    FSPathFileOperationStatusProcPtr
    FSPathFileOperationStatusProcPtr

Определяет функцию обратного вызова состояния для асинхронной работы файла на объекте, указанном с путем.

Объявление

Swift

typealias FSPathFileOperationStatusProcPtr = CFunctionPointer<((FSFileOperation!, UnsafePointer<Int8>, FSFileOperationStage, OSStatus, CFDictionary!, UnsafeMutablePointer<Void>) -> Void)>

Objective C

typedef void (*FSPathFileOperationStatusProcPtr) ( FSFileOperationRef fileOp, const char *currentItem, FSFileOperationStage stage, OSStatus error, CFDictionaryRef statusDictionary, void *info );

Параметры

`fileOp`	Работа файла.
`currentItem`	Путь UTF-8 объекта, в настоящее время перемещаемого или скопированный. Если работа завершена, этот параметр относится к цели (новый объект, соответствующий исходному объекту в целевом каталоге).
`stage`	Текущий этап работы.
`error`	Текущее ошибочное состояние работы.
`statusDictionary`	Словарь с более подробной информацией о статусе. Для получения информации о содержании словаря посмотрите `“File Operation Status Dictionary Keys”`. Вы не ответственны за выпуск словаря.
`info`	Указатель на определяемые пользователем данные связался с этой работой.

Обсуждение

Когда Вы вызываете FSPathCopyObjectAsync, FSPathMoveObjectAsync, или FSPathMoveObjectToTrashAsync, можно указать функцию обратного вызова состояния этого типа. Функция, которую Вы обеспечиваете, вызвана Файловым менеджером каждый раз, когда этапы изменений работы файла (включая сбой вследствие ошибки), или поскольку обновленная информация доступна ограниченный интервалом изменения состояния работы. Если необходимо сохранить какую-либо информацию о статусе вне объема обратного вызова, необходимо сделать копию информации.

Оператор импорта

Objective C

@import CoreServices;

Swift

import CoreServices

Доступность

Доступный в OS X v10.4 и позже.

Разные обратные вызовы


    
    FNSubscriptionProcPtr
    FNSubscriptionProcPtr

Обратный вызов поставлен для уведомлений каталога.

Объявление

Swift

typealias FNSubscriptionProcPtr = CFunctionPointer<((FNMessage, OptionBits, UnsafeMutablePointer<Void>, FNSubscription!) -> Void)>

Objective C

typedef void (*FNSubscriptionProcPtr) ( FNMessage message, OptionBits flags, void * refcon, FNSubscriptionRef subscription );

Параметры

`message`	Индикация относительно того, что произошло.
`flags`	Опции относительно поставки уведомления; обычно `kNilOptions`.
`refcon`	Указатель на справочник пользователя предоставляется подпиской.
`subscription`	Подписка, соответствующая этому уведомлению.

Оператор импорта

Objective C

@import CoreServices;

Swift

import CoreServices

Доступность

Доступный в OS X v10.1 и позже.


    
    FSVolumeEjectProcPtr
    FSVolumeEjectProcPtr

Объявление

Swift

typealias FSVolumeEjectProcPtr = CFunctionPointer<((FSVolumeOperation, UnsafeMutablePointer<Void>, OSStatus, FSVolumeRefNum, pid_t) -> Void)>

Objective C

typedef void (*FSVolumeEjectProcPtr) ( FSVolumeOperation volumeOp, void * clientData, OSStatus err, FSVolumeRefNum volumeRefNum, pid_t dissenter );

Параметры

`volumeOp`
`clientData`
`err`
`volumeRefNum`
`dissenter`

Оператор импорта

Objective C

@import CoreServices;

Swift

import CoreServices

Доступность

Доступный в OS X v10.2 и позже.


    
    FSVolumeMountProcPtr
    FSVolumeMountProcPtr

Объявление

Swift

typealias FSVolumeMountProcPtr = CFunctionPointer<((FSVolumeOperation, UnsafeMutablePointer<Void>, OSStatus, FSVolumeRefNum) -> Void)>

Objective C

typedef void (*FSVolumeMountProcPtr) ( FSVolumeOperation volumeOp, void * clientData, OSStatus err, FSVolumeRefNum mountedVolumeRefNum );

Параметры

`volumeOp`
`clientData`
`err`
`mountedVolumeRefNum`

Оператор импорта

Objective C

@import CoreServices;

Swift

import CoreServices

Доступность

Доступный в OS X v10.2 и позже.


    
    FSVolumeUnmountProcPtr
    FSVolumeUnmountProcPtr

Объявление

Swift

typealias FSVolumeUnmountProcPtr = CFunctionPointer<((FSVolumeOperation, UnsafeMutablePointer<Void>, OSStatus, FSVolumeRefNum, pid_t) -> Void)>

Objective C

typedef void (*FSVolumeUnmountProcPtr) ( FSVolumeOperation volumeOp, void * clientData, OSStatus err, FSVolumeRefNum volumeRefNum, pid_t dissenter );

Параметры

`volumeOp`
`clientData`
`err`
`volumeRefNum`
`dissenter`

Оператор импорта

Objective C

@import CoreServices;

Swift

import CoreServices

Доступность

Доступный в OS X v10.2 и позже.


    
    IOCompletionProcPtr
    IOCompletionProcPtr

Определяет указатель на функцию завершения. Ваша функция завершения выполняется Файловым менеджером после завершения асинхронного вызова функции Файлового менеджера.

Объявление

Swift

typealias IOCompletionProcPtr = CFunctionPointer<((ParmBlkPtr) -> Void)>

Objective C

typedef void (*IOCompletionProcPtr) ( ParmBlkPtr paramBlock );

Параметры


      paramBlock

Указатель на блок параметра, переданный асинхронной функции Файлового менеджера.

Возвращаемое значение

Обсуждение

Когда Вы выполняете асинхронную функцию Файлового менеджера ( Async функция), можно указать подпрограмму завершения путем передачи адреса подпрограммы в ioCompletion поле блока параметра передало функции. Поскольку Вы запросили асинхронное выполнение, Файловый менеджер помещает запрос I/O в очередь файлового ввода-вывода и возвращает управление Вашему приложению — возможно даже, прежде чем будет завершена фактическая операция I/O. Файловый менеджер берет запросы от очереди по одному и обрабатывает их между тем, Ваше приложение является бесплатным сделать другую обработку.

Функция, выполняемая асинхронно, возвращает управление Вашему приложению с кодом результата noErr как только вызов помещается в очередь файлового ввода-вывода. Этот код результата не указывает, что вызов успешно завершился, но просто указывает, что вызов был успешно помещен в очередь. Для определения, когда вызов фактически завершается можно проверить ioResult поле блока параметра. Это поле установлено в положительное число, когда вызов выполняется и устанавливается в фактический код результата, когда завершается вызов. При указании подпрограммы завершения она выполняется после того, как код результата помещается в ioResult.

Файловый менеджер, когда файловый сервер Совместного доступа к файлам или AppleShare будет активен, выполнит запросы в произвольном порядке. Это означает, что, если существует запрос, зависящий от завершения предыдущего запроса, это - ошибка для Вашей программы для выпуска второго запроса до завершения первого запроса. Например, выпуск запроса записи и затем выпуск запроса чтения на те же данные, как гарантируют, не считают назад, что было записано, если запрос чтения не выполнен, пока запрос записи не завершается.

Если результаты вызова в диске переключают диалоговое окно для возвращения оффлайнового объема онлайн, порядок запроса может также измениться.

Специальные замечания

Поскольку подпрограмма завершения выполняется во время прерывания, она не должна выделять, переместиться или произвести чистку памяти (любой прямо или косвенно) и не должна зависеть от законности дескрипторов к разблокированным блокам.

Если Ваша подпрограмма завершения использует глобальные переменные приложения, она должна также гарантировать, что регистр A5 содержит адрес границы между Вашими глобальными переменными приложения и Вашими параметрами приложения.

Оператор импорта

Objective C

@import CoreServices;

Swift

import CoreServices

Доступность

Доступный в OS X v10.0 и позже.

Типы данных


      
      AccessParam

Определяет блок параметра, используемый низкоуровневым файлом HFS и функциями манипулирования правами доступа каталога.

Объявление

Objective C

struct AccessParam { QElemPtr qLink; short qType; short ioTrap; Ptr ioCmdAddr; IOCompletionUPP ioCompletion; volatile OSErr ioResult; StringPtr ioNamePtr; short ioVRefNum; short filler3; short ioDenyModes; short filler4; SInt8 filler5; SInt8 ioACUser; long filler6; long ioACOwnerID; long ioACGroupID; long ioACAccess; long ioDirID; }; typedef struct AccessParam AccessParam; typedef AccessParam * AccessParamPtr;

Поля

`qLink`	Указатель на следующую запись в очереди файлового ввода-вывода. (Это поле используется внутренне Файловым менеджером для отслеживания асинхронные вызовы, ждущие выполнения.
`qType`	Тип очереди. Это поле используется внутренне Файловым менеджером.
`ioTrap`	Число прерывания вызванной функции. Это поле используется внутренне Файловым менеджером.
`ioCmdAddr`	Адрес вызванной функции. Это поле используется внутренне Файловым менеджером.
`ioCompletion`	Универсальный указатель процедуры на подпрограмму завершения, которая будет выполняться в конце асинхронного вызова. Это должно быть 0 для асинхронных вызовов без подпрограммы завершения и автоматически установлено в 0 для всех синхронных вызовов. Посмотрите `IOCompletionProcPtr` для получения информации о подпрограммах завершения.
`ioResult`	Код результата функции. Для синхронных вызовов это поле совпадает с кодом результата самого вызова функции. Для определения, когда асинхронный вызов был фактически завершен приложение может опросить это поле, это установлено в положительное число, когда вызов выполняется и получает фактический код результата, когда завершается вызов.
`ioNamePtr`	Указатель на путь. Каждый раз, когда функциональное описание указывает это `ioNamePtr` используется — очень важно ли для ввода, вывода или обоих — чтобы Вы установили это поле для указания на хранение для a `Str255` значение (если Вы используете путь), или к `NULL` (если Вы не).
`ioVRefNum`	Ссылочный номер объема, 0 для объема по умолчанию или числа диска.
`filler3`	Зарезервированный.
`ioDenyModes`	Информация о режиме доступа.
`filler4`	Зарезервированный.
`filler5`	Зарезервированный.
`ioACUser`	Права доступа пользователя для указанного каталога.
`filler6`	Зарезервированный.
`ioACOwnerID`	Владелец ID.
`ioACGroupID`	Группа ID.
`ioACAccess`	Права доступа каталога.
`ioDirID`

Доступность

Доступный в OS X v10.0 и позже.

Не доступный 64-разрядным приложениям.

AFPAlternateAddress

Определяет блок маркированных адресов для клиентов AppleShare.

Объявление

Swift

struct AFPAlternateAddress { var fVersion: UInt8 var fAddressCount: UInt8 var fAddressList: (UInt8) }

Objective C

struct AFPAlternateAddress { UInt8 fVersion; UInt8 fAddressCount; UInt8 fAddressList[1]; }; typedef struct AFPAlternateAddress AFPAlternateAddress;

Доступность

Доступный в OS X v10.0 и позже.


      
      AFPTagData

Определяет структуру, содержащую маркированную адресную информацию для клиентов AppleShare.

Объявление

Swift

struct AFPTagData { var fLength: UInt8 var fType: UInt8 var fData: (UInt8) }

Objective C

struct AFPTagData { UInt8 fLength; UInt8 fType; UInt8 fData[1]; }; typedef struct AFPTagData AFPTagData;

Поля

`fLength`	Длина, в байтах, этого тега данных, включая `fLength` само поле. Посмотрите Константы Длины Тега AFP.
`fType`	Тип тега данных. Посмотрите Константы Типа тега AFP для констант, которые можно использовать здесь.
`fData`	Данные переменной длины, содержа адрес.

Обсуждение

Новый маркированный формат данных для обращения допускает изменения в обращении форматов, позволяя клиентам AppleShare поддерживать новые стандарты обращения, не изменяя интерфейс. AFPAlternateAddress структура данных использует AFPTagData структура для указания маркированного адреса.

Доступность

Доступный в OS X v10.0 и позже.


      
      AFPVolMountInfo

Определяет структуру монтирования объема для сервера AppleShare.

Объявление

Swift

struct AFPVolMountInfo { var length: Int16 var media: VolumeType var flags: Int16 var nbpInterval: Int8 var nbpCount: Int8 var uamType: Int16 var zoneNameOffset: Int16 var serverNameOffset: Int16 var volNameOffset: Int16 var userNameOffset: Int16 var userPasswordOffset: Int16 var volPasswordOffset: Int16 var AFPData: (Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8) }

Objective C

struct AFPVolMountInfo { short length; VolumeType media; short flags; SInt8 nbpInterval; SInt8 nbpCount; short uamType; short zoneNameOffset; short serverNameOffset; short volNameOffset; short userNameOffset; short userPasswordOffset; short volPasswordOffset; char AFPData[144]; }; typedef struct AFPVolMountInfo AFPVolMountInfo; typedef AFPVolMountInfo * AFPVolMountInfoPtr;

Поля

`length`	Длина `AFPVolMountInfo` структура (т.е. общая длина заголовка структуры, описанного здесь плюс данные расположения переменной длины).
`media`	Тип объема удаленного объема. Значение `AppleShareMediaType` (константа, переводящая в `'afpm'`) представляет объем AppleShare.
`flags`	Если бит 0 установлен, никакое сообщение приветствия от сервера не выведено на экран.
`nbpInterval`	NBP ретранслируют интервал в модулях 8 галочек.
`nbpCount`	NBP ретранслируют количество. Это поле указывает общее количество времен, пакет должен быть передан, включая первую передачу.
`uamType`	Метод аутентификации пользователей используется удаленным объемом. AppleShare использует четыре метода, определенные константами, описанными в Константах Метода аутентификации.
`zoneNameOffset`	Смещение в байтах с начала структуры к записи в `AFPData` поле, содержащее имя (как строка Паскаля) зоны AppleShare.
`serverNameOffset`	Смещение в байтах с начала структуры к записи в `AFPData` поле, содержащее имя (как строка Паскаля) сервера AppleShare.
`volNameOffset`	Смещение в байтах с начала структуры к записи в `AFPData` поле, содержащее имя (как строка Паскаля) объема.
`userNameOffset`	Смещение в байтах с начала структуры к записи в `AFPData` поле, содержащее имя (как строка Паскаля) пользователя.
`userPasswordOffset`	Смещение в байтах с начала структуры к записи в `AFPData` поле, содержащее пароль пользователя (как строка Паскаля).
`volPasswordOffset`	Смещение в байтах с начала структуры к записи в `AFPData` поле, содержащее пароль объема (как строка Паскаля). Некоторые версии программного обеспечения AppleShare не передают информацию в этом поле к серверу.
`AFPData`	Фактическая информация о монтировании объема, смещения, к которым содержатся в предшествовании шести полям. Для монтирования объема AFP необходимо заполнить структуру с, по крайней мере, именем зоны, именем сервера, именем пользователя, паролем пользователя и паролем тома. Можно разметить данные в любом порядке в этом поле данных, пока Вы указываете корректные смещения в полях смещения.

Обсуждение

Единственные объемы, в настоящее время поддерживающие программируемые функции монтирования, являются серверами AppleShare, использующими структуру монтирования объема типа AFPVolMountInfo.

Для монтирования сервера AppleShare заполните AFPVolMountInfo структура с помощью PBGetVolMountInfo функционируйте и затем передайте эту структуру PBVolumeMount функционируйте для монтирования объема.

Доступность

Доступный в OS X v10.0 и позже.


      
      AFPXVolMountInfo

Определяет структуру монтирования объема для сервера AppleShare, для AppleShare 3.7 и позже.

Объявление

Swift

struct AFPXVolMountInfo { var length: Int16 var media: VolumeType var flags: Int16 var nbpInterval: Int8 var nbpCount: Int8 var uamType: Int16 var zoneNameOffset: Int16 var serverNameOffset: Int16 var volNameOffset: Int16 var userNameOffset: Int16 var userPasswordOffset: Int16 var volPasswordOffset: Int16 var extendedFlags: Int16 var uamNameOffset: Int16 var alternateAddressOffset: Int16 var AFPData: (Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8, Int8) }

Objective C

struct AFPXVolMountInfo { short length; VolumeType media; short flags; SInt8 nbpInterval; SInt8 nbpCount; short uamType; short zoneNameOffset; short serverNameOffset; short volNameOffset; short userNameOffset; short userPasswordOffset; short volPasswordOffset; short extendedFlags; short uamNameOffset; short alternateAddressOffset; char AFPData[176]; }; typedef struct AFPXVolMountInfo AFPXVolMountInfo; typedef AFPXVolMountInfo * AFPXVolMountInfoPtr;

Поля

`length`	Длина `AFPXVolMountInfo` структура (т.е. общая длина заголовка структуры, описанного здесь плюс данные расположения переменной длины).
`media`	Тип объема удаленного объема. Значение `AppleShareMediaType` (константа, переводящая в `'afpm'`) представляет объем AppleShare.
`flags`	Объем монтирует флаги. Посмотрите, что Объем Монтирует Флаги для описания битов в этом поле. Для использования новых функций расширенного объема AFP, монтируют структуру, необходимо установить `volMountExtendedFlagsBit` бит.
`nbpInterval`	NBP ретранслируют интервал в модулях 8 галочек.
`nbpCount`	NBP ретранслируют количество. Это поле указывает общее количество времен, пакет должен быть передан, включая первую передачу.
`uamType`	Метод аутентификации пользователей используется удаленным объемом. AppleShare использует четыре метода, определенные константами, описанными в Константах Метода аутентификации.
`zoneNameOffset`	Смещение в байтах с начала структуры к записи в `AFPData` поле, содержащее имя (как строка Паскаля) зоны AppleShare.
`serverNameOffset`	Смещение в байтах с начала структуры к записи в `AFPData` поле, содержащее имя (как строка Паскаля) сервера AppleShare.
`volNameOffset`	Смещение в байтах с начала структуры к записи в `AFPData` поле, содержащее имя (как строка Паскаля) объема.
`userNameOffset`	Смещение в байтах с начала структуры к записи в `AFPData` поле, содержащее имя (как строка Паскаля) пользователя.
`userPasswordOffset`	Смещение в байтах с начала структуры к записи в `AFPData` поле, содержащее пароль пользователя (как строка Паскаля).
`volPasswordOffset`	Смещение в байтах с начала структуры к записи в `AFPData` поле, содержащее пароль объема (как строка Паскаля). Некоторые версии программного обеспечения AppleShare не передают информацию в этом поле к серверу.
`extendedFlags`	Расширенные флаги. Посмотрите, что Расширенный Объем AFP Монтирует информационный Флаг.
`uamNameOffset`	Смещение в байтах с начала структуры к записи в `AFPData` поле, содержащее имя модуля аутентификации пользователя (как строка Паскаля).
`alternateAddressOffset`	Смещение в байтах с начала структуры к записи в `AFPData` поле, содержащее IP-адреса, указанные как блок маркированных данных. Этот блок маркированных данных начинается с байта версии и байта количества, сопровождаемого до 255 маркированных адресов. Посмотрите `AFPAlternateAddress`.
`AFPData`	Фактическая информация о монтировании объема, смещения, к которым содержатся в предыдущих полях. Для монтирования объема AFP необходимо заполнить структуру с, по крайней мере, именем зоны, именем сервера, именем пользователя, паролем пользователя и паролем тома. Можно разметить данные в любом порядке в этом поле данных, пока Вы указываете корректные смещения в полях смещения.

Обсуждение

Для монтирования сервера AppleShare заполните AFPXVolMountInfo структура с помощью PBGetVolMountInfo функционируйте и затем передайте эту структуру PBVolumeMount функционируйте для монтирования объема.

Расширенный объем AFP монтирует, что информационная структура требует клиента AppleShare 3.7 и позже. Новые поля и флаговые биты позволяют Вам указывать, что информация должна была поддерживать Модули Аутентификации пользователя и TCP/IP.

Обратите внимание на то, что, для всех полей, указывающих смещение, если Вы хотите оставить строковое поле внутри AFPData пустое поле, необходимо указать пустую строку и иметь смещение в соответствующей полевой точке смещения к той пустой строке. Вы не можете просто передать 0 как смещение.

Доступность

Доступный в OS X v10.0 и позже.


      
      CatPositionRec

Определяет структуру позиции каталога, поддерживающую текущую позицию поиска каталога между вызовами к PBCatSearchSync или PBCatSearchAsync.

Объявление

Swift

struct CatPositionRec { var initialize: Int32 var priv: (Int16, Int16, Int16, Int16, Int16, Int16) }

Objective C

struct CatPositionRec { long initialize; short priv[6]; }; typedef struct CatPositionRec CatPositionRec;

Поля

`initialize`	Начальная точка поиска каталога. Чтобы начать искать в начале каталога, укажите 0 в этом поле. Для возобновления предыдущего поиска передайте значение, возвращенное предыдущим вызовом к `PBCatSearchSync` или `PBCatSearchAsync`.
`priv`	Массив целых чисел, использующийся внутренне `PBCatSearchSync` и `PBCatSearchAsync`.

Обсуждение

Когда Вы вызываете PBCatSearchSync или PBCatSearchAsync функционируйте для поиска файла каталога объема, можно указать, в ioCatPosition поле блока параметра передало PBCatSearchSync и PBCatSearchAsync, структура позиции каталога. Если поиск каталога использует больше времени, чем позволяется ioSearchTime поле, PBCatSearchSync и PBCatSearchAsync сохраните индекс расположения каталога в той структуре; когда Вы вызываете PBCatSearchSync или PBCatSearchAsync снова, это использует ту структуру, чтобы продолжить искать, где это кончило.

Доступность

Доступный в OS X v10.0 и позже.

CInfoPBRec

Определяет блок параметра информации о каталоге для получения информации о каталоге и файла.

Объявление

Objective C

union CInfoPBRec { HFileInfo hFileInfo; DirInfo dirInfo; }; typedef union CInfoPBRec CInfoPBRec; typedef CInfoPBRec * CInfoPBPtr;

Поля

hFileInfo

dirInfo

Доступность

Доступный в OS X v10.0 и позже.
Не доступный 64-разрядным приложениям.


      
      CMovePBRec

Определяет блок параметра, используемый с функциями PBCatMoveSync и PBCatMoveAsync.

Объявление

Objective C

struct CMovePBRec { QElemPtr qLink; short qType; short ioTrap; Ptr ioCmdAddr; IOCompletionUPP ioCompletion; volatile OSErr ioResult; StringPtr ioNamePtr; short ioVRefNum; long filler1; StringPtr ioNewName; long filler2; long ioNewDirID; long filler3[2]; long ioDirID; }; typedef struct CMovePBRec CMovePBRec; typedef CMovePBRec * CMovePBPtr;

Поля

`qLink`	Указатель на следующую запись в очереди файлового ввода-вывода. (Это поле используется внутренне Файловым менеджером для отслеживания асинхронные вызовы, ждущие выполнения.
`qType`	Тип очереди (Это поле используется внутренне Файловым менеджером.
`ioTrap`	Число прерывания вызванной функции. Это поле используется внутренне Файловым менеджером.
`ioCmdAddr`	Адрес вызванной функции. Это поле используется внутренне Файловым менеджером.
`ioCompletion`	Универсальный указатель процедуры на подпрограмму завершения, которая будет выполняться в конце асинхронного вызова. Это должно быть 0 для асинхронных вызовов без подпрограммы завершения и автоматически установлено в 0 для всех синхронных вызовов. Посмотрите `IOCompletionProcPtr` для получения информации о подпрограммах завершения.
`ioResult`	Код результата функции. Для синхронных вызовов это поле совпадает с кодом результата самого вызова функции. Для определения, когда асинхронный вызов был фактически завершен приложение может опросить это поле, это установлено в положительное число, когда вызов выполняется и получает фактический код результата, когда завершается вызов.
`ioNamePtr`	Указатель на путь. Каждый раз, когда функциональное описание указывает это `ioNamePtr` используется — очень важно ли для ввода, вывода или обоих — чтобы Вы установили это поле для указания на хранение для a `Str255` значение (если Вы используете путь), или к `NULL` (если Вы не).
`ioVRefNum`	Ссылочный номер объема, 0 для объема по умолчанию или числа диска.
`filler1`	Зарезервированный.
`ioNewName`	Имя каталога, в который должен быть перемещен указанный файл или каталог.
`filler2`	Зарезервированный.
`ioNewDirID`	Каталог ID каталога, в который должен быть перемещен указанный файл или каталог.
`filler3`	Зарезервированный.
`ioDirID`	Текущий каталог ID файла или каталога, который будет перемещен (используемый в сочетании с `ioVRefNum` и `ioNamePtr` поля).

Обсуждение

Низкоуровневая функция HFS PBCatMove использует блок параметра перемещения каталога, определенный CMovePBRec тип данных.

Доступность

Доступный в OS X v10.0 и позже.

Не доступный 64-разрядным приложениям.


      
      CntrlParam

Определяет блок параметра, используемый управлением и функциями состояния в классическом Диспетчере устройств.

Объявление

Objective C

struct CntrlParam { QElemPtr qLink; short qType; short ioTrap; Ptr ioCmdAddr; IOCompletionUPP ioCompletion; volatile OSErr ioResult; StringPtr ioNamePtr; short ioVRefNum; short ioCRefNum; short csCode; short csParam[11]; }; typedef struct CntrlParam CntrlParam; typedef CntrlParam * CntrlParamPtr;

Поля

`qLink`	Указатель на следующую запись в очереди файлового ввода-вывода. (Это поле используется внутренне Файловым менеджером для отслеживания асинхронные вызовы, ждущие выполнения.
`qType`	Тип очереди. Это поле используется внутренне Файловым менеджером.
`ioTrap`	Число прерывания вызванной функции. Это поле используется внутренне Файловым менеджером.
`ioCmdAddr`	Адрес вызванной функции. Это поле используется внутренне Файловым менеджером.
`ioCompletion`	Универсальный указатель процедуры на подпрограмму завершения, которая будет выполняться в конце асинхронного вызова. Это должно быть 0 для асинхронных вызовов без подпрограммы завершения и автоматически установлено в 0 для всех синхронных вызовов. Посмотрите `IOCompletionProcPtr` для получения информации о подпрограммах завершения.
`ioResult`	Код результата функции. Для синхронных вызовов это поле совпадает с кодом результата самого вызова функции. Для определения, когда асинхронный вызов был фактически завершен приложение может опросить это поле, это установлено в положительное число, когда вызов выполняется и получает фактический код результата, когда завершается вызов.
`ioNamePtr`	Указатель на путь. Каждый раз, когда функциональное описание указывает это `ioNamePtr` используется — очень важно ли для ввода, вывода или обоих — чтобы Вы установили это поле для указания на хранение для a `Str255` значение (если Вы используете путь), или к `NULL` (если Вы не).
`ioVRefNum`	Ссылочный номер объема, 0 для объема по умолчанию или числа диска.
`ioCRefNum`	Ссылочный номер драйвера для операции I/O.
`csCode`	Значение, идентифицирующее тип управления или запроса о состоянии. Каждый драйвер может интерпретировать это число по-другому.
`csParam`	Управляющая информация или информация о статусе передали или от драйвера. Это поле объявляется в общем как массив одиннадцати целых чисел. Каждый драйвер может интерпретировать содержание этого поля по-другому. Обратитесь к водительской документации для определенной информации.

Доступность

Доступный в OS X v10.0 и позже.

Не доступный 64-разрядным приложениям.

ConstFSSpecPtr ConstFSSpecPtr

Определяет указатель на FSSpec структура.

Объявление

Swift

typealias ConstFSSpecPtr = UnsafePointer<FSSpec>

Objective C

typedef const FSSpec* ConstFSSpecPtr;

Обсуждение

Единственная разница между “const FSSpec*” и ConstFSSpecPtr тип данных то, что, в качестве параметра, a ConstFSSpecPtr типу данных позволяют быть NULL. Посмотрите FSSpec.

Оператор импорта

Objective C

@import CoreServices;

Swift

import CoreServices

Доступность

Доступный в OS X v10.0 и позже.
ConstHFSUniStr255Param ConstHFSUniStr255Param

Определяет указатель на HFSUniStr255 структура.

Объявление

Swift

typealias ConstHFSUniStr255Param = UnsafePointer<HFSUniStr255>

Objective C

typedef const HFSUniStr255* ConstHFSUniStr255Param;

Обсуждение

Посмотрите HFSUniStr255.

Оператор импорта

Objective C

#include <hfs/hfs_unistr.h>;

Swift

import Darwin

Доступность

Доступный в OS X v10.0 и позже.


      
      CopyParam

Определяет блок параметра, используемый низкоуровневыми функциями копирования файла HFS.

Объявление

Objective C

struct CopyParam { QElemPtr qLink; short qType; short ioTrap; Ptr ioCmdAddr; IOCompletionUPP ioCompletion; volatile OSErr ioResult; StringPtr ioNamePtr; short ioVRefNum; short ioDstVRefNum; short filler8; StringPtr ioNewName; StringPtr ioCopyName; long ioNewDirID; long filler14; long filler15; long ioDirID; }; typedef struct CopyParam CopyParam; typedef CopyParam * CopyParamPtr;

Поля

`qLink`	Указатель на следующую запись в очереди файлового ввода-вывода. (Это поле используется внутренне Файловым менеджером для отслеживания асинхронные вызовы, ждущие выполнения.
`qType`	Тип очереди. Это поле используется внутренне Файловым менеджером.
`ioTrap`	Число прерывания вызванной функции. Это поле используется внутренне Файловым менеджером.
`ioCmdAddr`	Адрес вызванной функции. Это поле используется внутренне Файловым менеджером.
`ioCompletion`	Универсальный указатель процедуры на подпрограмму завершения, которая будет выполняться в конце асинхронного вызова. Это должно быть 0 для асинхронных вызовов без подпрограммы завершения и автоматически установлено в 0 для всех синхронных вызовов. Посмотрите `IOCompletionProcPtr` для получения информации о подпрограммах завершения.
`ioResult`	Код результата функции. Для синхронных вызовов это поле совпадает с кодом результата самого вызова функции. Для определения, когда асинхронный вызов был фактически завершен приложение может опросить это поле, это установлено в положительное число, когда вызов выполняется и получает фактический код результата, когда завершается вызов.
`ioNamePtr`	Указатель на путь. Каждый раз, когда функциональное описание указывает это `ioNamePtr` используется — очень важно ли для ввода, вывода или обоих — чтобы Вы установили это поле для указания на хранение для a `Str255` значение (если Вы используете путь), или к `NULL` (если Вы не).
`ioVRefNum`	Ссылочный номер объема, 0 для объема по умолчанию или числа диска.
`ioDstVRefNum`	Ссылочный номер объема для целевого объема.
`filler8`	Зарезервированный.
`ioNewName`	Указатель на целевой путь.
`ioCopyName`	Указатель на дополнительное имя.
`ioNewDirID`	Целевой каталог ID.
`filler14`	Зарезервированный.
`filler15`	Зарезервированный.
`ioDirID`	Каталог ID.

Доступность

Доступный в OS X v10.0 и позже.

Не доступный 64-разрядным приложениям.


      
      CSParam

Определяет блок параметра, используемый низкоуровневыми функциями поиска каталога HFS.

Объявление

Objective C

struct CSParam { QElemPtr qLink; short qType; short ioTrap; Ptr ioCmdAddr; IOCompletionUPP ioCompletion; volatile OSErr ioResult; StringPtr ioNamePtr; short ioVRefNum; FSSpecPtr ioMatchPtr; long ioReqMatchCount; long ioActMatchCount; long ioSearchBits; CInfoPBPtr ioSearchInfo1; CInfoPBPtr ioSearchInfo2; long ioSearchTime; CatPositionRec ioCatPosition; Ptr ioOptBuffer; long ioOptBufSize; }; typedef struct CSParam CSParam; typedef CSParam * CSParamPtr;

Поля

`qLink`	Указатель на следующую запись в очереди файлового ввода-вывода. (Это поле используется внутренне Файловым менеджером для отслеживания асинхронные вызовы, ждущие выполнения.
`qType`	Тип очереди. Это поле используется внутренне Файловым менеджером.
`ioTrap`	Число прерывания вызванной функции. Это поле используется внутренне Файловым менеджером.
`ioCmdAddr`	Адрес вызванной функции. Это поле используется внутренне Файловым менеджером.
`ioCompletion`	Универсальный указатель процедуры на подпрограмму завершения, которая будет выполняться в конце асинхронного вызова. Это должно быть 0 для асинхронных вызовов без подпрограммы завершения и автоматически установлено в 0 для всех синхронных вызовов. Посмотрите `IOCompletionProcPtr` для получения информации о подпрограммах завершения.
`ioResult`	Код результата функции. Для синхронных вызовов это поле совпадает с кодом результата самого вызова функции. Для определения, когда асинхронный вызов был фактически завершен приложение может опросить это поле, это установлено в положительное число, когда вызов выполняется и получает фактический код результата, когда завершается вызов.
`ioNamePtr`	Указатель на путь. Каждый раз, когда функциональное описание указывает это `ioNamePtr` используется — очень важно ли для ввода, вывода или обоих — чтобы Вы установили это поле для указания на хранение для a `Str255` значение (если Вы используете путь), или к `NULL` (если Вы не).
`ioVRefNum`	Ссылочный номер объема, 0 для объема по умолчанию или числа диска.
`ioMatchPtr`	Указатель на массив `FSSpec` структуры, в которых возвращаются имена файлов и имена каталогов, соответствующие критерии выбора. Массив должен быть достаточно большим для содержания самого большого числа `FSSpec` структуры, как определено `ioReqMatchCount` поле.
`ioReqMatchCount`	Максимальное количество соответствий для возврата. Это число должно быть числом `FSSpec` структуры, которые поместятся в память, на которую указывают `ioMatchPtr` поле. Можно использовать это поле для предотвращения возможного избытка соответствий для критериев, которые, оказывается, являются слишком общими (или ограничить продолжительность поиска, если `ioSearchTime` поле не используется).
`ioActMatchCount`	Число фактических соответствий найдено.
`ioSearchBits`	Поля параметра блокируют в `ioSearchInfo1` и `ioSearchInfo2` поля, относящиеся к поиску. Посмотрите Биты Поиска Каталога для получения дополнительной информации.
`ioSearchInfo1`	Указатель на a `CInfoPBRec` блок параметра, содержащий поисковую информацию. Для значений, соответствующих маской и значением (Информация о средстве поиска, например), устанавливают биты в структуре, переданной в `ioSearchInfo2` поле и набор совпадающие значения в этой структуре. Для значений, соответствующих против диапазона (такого как даты), установите нижние границы для диапазона в этой структуре.
`ioSearchInfo2`	Указатель на секунду `CInfoPBRec` блок параметра, содержащий поисковую информацию. Для значений, соответствующих маской и значением (Информация о средстве поиска, например), устанавливают биты в этой структуре и устанавливают совпадающие значения в структуре, переданной в `ioSearchInfo1` поле. Для значений, соответствующих против диапазона (такого как даты), установите верхние границы для диапазона в этой структуре.
`ioSearchTime`	Ограничение по времени на поиске, в формате Тайм менеджера. Используйте это поле для ограничения времени выполнения единственного вызова к `PBCatSearchSync` или `PBCatSearchAsync`. Значение 0 не налагает ограничения по времени. Если значение этого поля положительно, это интерпретируется как миллисекунды. Если значение этого поля отрицательно, это интерпретируется как отрицаемые микросекунды.
`ioCatPosition`	Позиция в каталоге, где должен начаться поиск. Используйте это поле для хранения индекса в каталог при разрушении `PBCatSearchSync` или `PBCatSearchAsync` поиск во многие меньшие поиски. Это поле допустимо каждый раз, когда `PBCatSearchSync` или `PBCatSearchAsync` выходы, потому что это любой проводит максимальное время, позволенное `ioSearchTime` или считает максимальное количество соответствий позволенным `ioReqMatchCount`. Для запуска в начале каталога установите `initialize` поле `ioCatPosition` к 0. Прежде, чем выйти после прерванного поиска, `PBCatSearchSync` или `PBCatSearchAsync` наборы, что поле к следующему каталогизационному описанию, которое будет искаться. Для возобновления, где предыдущий вызов остановился передайте все `CatPositionRec` структура, возвращенная предыдущим вызовом, как введено к следующему.
`ioOptBuffer`	Указатель на дополнительный буфер чтения. `ioOptBuffer` и `ioOptBufSize` поля позволяют Вам указать часть памяти как буфер чтения, увеличивая поисковую скорость.
`ioOptBufSize`	Размер буфера, которым указывают `ioOptBuffer`. Эффективность размера буфера меняется в зависимости от моделей и конфигураций, но буфер на 16 КБ, вероятно, будет оптимален. Размер должен составлять по крайней мере 1 024 байта и должен быть интегральным кратным числом 512 байтов.

Доступность

Доступный в OS X v10.0 и позже.

Не доступный 64-разрядным приложениям.


      
      DirInfo

Определяет структуру, содержащую информацию о каталоге о каталоге.

Объявление

Objective C

struct DirInfo { QElemPtr qLink; short qType; short ioTrap; Ptr ioCmdAddr; IOCompletionUPP ioCompletion; volatile OSErr ioResult; StringPtr ioNamePtr; short ioVRefNum; short ioFRefNum; SInt8 ioFVersNum; SInt8 filler1; short ioFDirIndex; SInt8 ioFlAttrib; SInt8 ioACUser; DInfo ioDrUsrWds; long ioDrDirID; unsigned short ioDrNmFls; short filler3[9]; unsigned long ioDrCrDat; unsigned long ioDrMdDat; unsigned long ioDrBkDat; DXInfo ioDrFndrInfo; long ioDrParID; }; typedef struct DirInfo DirInfo;

Поля

`qLink`	Указатель на следующую запись в очереди файлового ввода-вывода. (Это поле используется внутренне Файловым менеджером для отслеживания асинхронные вызовы, ждущие выполнения.
`qType`	Тип очереди. Это поле используется внутренне Файловым менеджером.
`ioTrap`	Число прерывания вызванной функции. Это поле используется внутренне Файловым менеджером.
`ioCmdAddr`	Адрес вызванной функции. Это поле используется внутренне Файловым менеджером.
`ioCompletion`	Универсальный указатель процедуры на подпрограмму завершения, которая будет выполняться в конце асинхронного вызова. Это должно быть 0 для асинхронных вызовов без подпрограммы завершения и автоматически установлено в 0 для всех синхронных вызовов. Посмотрите `IOCompletionProcPtr` для получения информации о подпрограммах завершения.
`ioResult`	Код результата функции. Для синхронных вызовов это поле совпадает с кодом результата самого вызова функции. Для определения, когда асинхронный вызов был фактически завершен приложение может опросить это поле, это установлено в положительное число, когда вызов выполняется и получает фактический код результата, когда завершается вызов.
`ioNamePtr`	Указатель на путь. Каждый раз, когда функциональное описание указывает это `ioNamePtr` используется — очень важно ли для ввода, вывода или обоих — чтобы Вы установили это поле для указания на хранение для a `Str255` значение (если Вы используете путь), или к `NULL` (если Вы не).
`ioVRefNum`	Ссылочный номер объема, 0 для объема по умолчанию или числа диска.
`ioFRefNum`	Число ссылки на файл открытого файла.
`ioFVersNum`	Номер версии файла. Это поле больше не используется. Номера версии файла являются артефактом устаревшего MFS и не поддерживаются на объемах HFS. Необходимо всегда устанавливать это поле в 0.
`filler1`	Зарезервированный.
`ioFDirIndex`	Файл и индекс каталога. Если это поле содержит положительное число, `PBGetCatInfoSync` и `PBGetCatInfoAsync` возвратите информацию о файле или каталоге, имеющем тот индекс каталога в каталоге, указанном `ioVRefNum` поле. (Если `ioVRefNum` содержит ссылочный номер объема, указанный каталог то, что корневой каталог объема.) Если это поле содержит 0, `PBGetCatInfoSync` и `PBGetCatInfoAsync` возвратите информацию о файле или каталоге, имя которого указано в `ioNamePtr` поле и это расположены в каталоге, указанном `ioVRefNum` поле. (Еще раз, если `ioVRefNum` содержит ссылочный номер объема, указанный каталог то, что корневой каталог объема.) Если это поле содержит отрицательное число, `PBGetCatInfoSync` и `PBGetCatInfoAsync` проигнорируйте `ioNamePtr` поле и информация о возвратах о каталоге, указанном в `ioDirID` поле. Если оба `ioDirID` и `ioVRefNum` установлены в 0, `PBGetCatInfoSync` и `PBGetCatInfoAsync` возвратите информацию о текущем каталоге по умолчанию.
`ioFlAttrib`	Атрибуты файла или каталога. Посмотрите Константы Атрибута файла для значения битов в этом поле.
`ioACUser`	Права доступа пользователя для указанного каталога. Посмотрите Константы Полномочий пользователя для значения битов в этом поле.
`ioDrUsrWds`	Информация используется Средством поиска.
`ioDrDirID`	Каталог ID. На вводе к `PBGetCatInfoSync` и `PBGetCatInfoAsync` , это поле содержит каталог ID, использующийся только если значение `ioFDirIndex` поле отрицательно. На выводе это поле содержит каталог ID указанного каталога.
`ioDrNmFls`	Число файлов в каталоге.
`filler3`	Зарезервированный.
`ioDrCrDat`	Дата и время создания каталога, в секундах с полуночи, 1 января 1904. Однако на OS X при установке даты создания в дату между 1 января 1904 и 1 января 1970 она будет отсечена до 1 января 1970, и это - значение, которое будет возвращено, если Вы позже попытаетесь получить дату создания. Обратите внимание на то, что файловые системы кроме AFP, HFS и HFS Плюс обычно не поддерживают даты создания.
`ioDrMdDat`	Дата и время последнего изменения к каталогу, в секундах с полуночи, 1 января 1904. Однако на OS X, если Вы назначаете дату модификации к дате между 1 января 1904 и 1 января 1970, она будет отсечена до 1 января 1970.
`ioDrBkDat`	Дата и время, что каталог был в последний раз скопирован, в секундах с полуночи, 1 января 1904. Однако на OS X, если Вы назначаете резервную дату к дате между 1 января 1904 и 1 января 1970, она будет отсечена до 1 января 1970. Обратите внимание на то, что файловые системы кроме AFP, HFS и HFS Плюс обычно не поддерживают резервные даты.
`ioDrFndrInfo`	Дополнительная информация используется Средством поиска.
`ioDrParID`	Каталог ID родительского каталога указанного каталога.
`refCon`

Доступность

Доступный в OS X v10.0 и позже.

Не доступный 64-разрядным приложениям.


      
      DrvQEl

Определяет элемент очереди диска.

Объявление

Objective C

struct DrvQEl { QElemPtr qLink; short qType; short dQDrive; short dQRefNum; short dQFSID; unsigned short dQDrvSz; unsigned short dQDrvSz2; }; typedef struct DrvQEl DrvQEl; typedef DrvQEl * DrvQElPtr;

Поля

`qLink`	Указатель на следующую запись в очереди диска.
`qType`	Используемый для указания размера диска. Если значение этого поля 0, число логических блоков на диске содержится в `dQDrvSz` одно только поле. Если значение этого поля равняется 1, оба `dQDrvSz` поле и `dQDrvSz2` поле используется для хранения числа блоков; в этом случае, `dQDrvSz2` поле содержит старшее слово этого числа и `dQDrvSz` содержит слово младшего разряда.
`dQDrive`	Число диска диска.
`dQRefNum`	Ссылочный номер драйвера драйвера, управляющего устройством, на котором смонтирован объем.
`dQFSID`	Идентификатор для файловой системы, обрабатывающей объем в диске, это - нуль для объемов, обработанных Файловым менеджером и ненулевых для объемов, обработанных другими файловыми системами.
`dQDrvSz`	Число логических блоков на диске.
`dQDrvSz2`	Дополнительное поле для обработки больших дисков. Это поле только используется если `qType` поле равняется 1.

Обсуждение

Файловый менеджер ведет список всех дисководов, подключенных к компьютеру. Это ведет этот список в очереди диска, которая является стандартной очередью операционной системы. В системное время запуска первоначально создается очередь диска. Когда Вы вызываете, элементы добавляются к очереди в системное время запуска или AddDrive функция. Очередь диска может поддерживать любое число дисков, ограниченных только пространством памяти. Каждый элемент в очереди диска содержит информацию о соответствующем диске.

Доступность

Доступный в OS X v10.0 и позже.

Не доступный 64-разрядным приложениям.


      
      DTPBRec

Определяет настольный блок параметра базы данных, используемый настольными функциями базы данных.

Объявление

Objective C

struct DTPBRec { QElemPtr qLink; short qType; short ioTrap; Ptr ioCmdAddr; IOCompletionUPP ioCompletion; volatile OSErr ioResult; StringPtr ioNamePtr; short ioVRefNum; short ioDTRefNum; short ioIndex; long ioTagInfo; Ptr ioDTBuffer; long ioDTReqCount; long ioDTActCount; SInt8 ioFiller1; UInt8 ioIconType; short ioFiller2; long ioDirID; OSType ioFileCreator; OSType ioFileType; long ioFiller3; long ioDTLgLen; long ioDTPyLen; short ioFiller4[14]; long ioAPPLParID; }; typedef struct DTPBRec DTPBRec; typedef DTPBRec * DTPBPtr;

Поля

`qLink`	Указатель на следующую запись в очереди файлового ввода-вывода. (Это поле используется внутренне Файловым менеджером для отслеживания асинхронные вызовы, ждущие выполнения.
`qType`	Тип очереди. Это поле используется внутренне Файловым менеджером.
`ioTrap`	Число прерывания вызванной функции. Это поле используется внутренне Файловым менеджером.
`ioCmdAddr`	Адрес вызванной функции. Это поле используется внутренне Файловым менеджером.
`ioCompletion`	Универсальный указатель процедуры на подпрограмму завершения, которая будет выполняться в конце асинхронного вызова. Это должно быть 0 для асинхронных вызовов без подпрограммы завершения и автоматически установлено в 0 для всех синхронных вызовов. Посмотрите `IOCompletionProcPtr` для получения информации о подпрограммах завершения.
`ioResult`	Код результата функции. Для синхронных вызовов это поле совпадает с кодом результата самого вызова функции. Для определения, когда асинхронный вызов был фактически завершен приложение может опросить это поле, это установлено в положительное число, когда вызов выполняется и получает фактический код результата, когда завершается вызов.
`ioNamePtr`	Указатель на файл, каталог или имя тома. Каждый раз, когда функциональное описание указывает это `ioNamePtr` используется — очень важно ли для ввода, вывода или обоих — чтобы Вы установили это поле для указания на хранение для a `Str255` значение (если Вы используете путь), или к `NULL` (если Вы не).
`ioVRefNum`	Ссылочный номер объема.
`ioDTRefNum`	Настольное число ссылки на базу данных.
`ioIndex`	Индекс в список значка.
`ioTagInfo`	Данные меток.
`ioDTBuffer`	Буфер данных.
`ioDTReqCount`	Требуемая длина данных.
`ioDTActCount`	Фактическая длина данных.
`ioFiller1`	Неиспользованный.
`ioIconType`	Тип значков.
`ioFiller2`	Неиспользованный.
`ioDirID`	Родительский каталог ID.
`ioFileCreator`	Создатель файла.
`ioFileType`	Тип файла.
`ioFiller3`	Неиспользованный.
`ioDTLgLen`	Логическая длина настольной базы данных.
`ioDTPyLen`	Физическая длина настольной базы данных.
`ioFiller4`	Неиспользованный.
`ioAPPLParID`	Родительский каталог ID приложения.

Доступность

Доступный в OS X v10.0 и позже.

Не доступный 64-разрядным приложениям.


      
      FCBPBRec

Определяет блок параметра блока управления файлом (FCB), используемый функциями PBGetFCBInfoSync и PBGetFCBInfoAsync.

Объявление

Objective C

struct FCBPBRec { QElemPtr qLink; short qType; short ioTrap; Ptr ioCmdAddr; IOCompletionUPP ioCompletion; volatile OSErr ioResult; StringPtr ioNamePtr; short ioVRefNum; short ioRefNum; short filler; short ioFCBIndx; short filler1; long ioFCBFlNm; short ioFCBFlags; unsigned short ioFCBStBlk; long ioFCBEOF; long ioFCBPLen; long ioFCBCrPs; short ioFCBVRefNum; long ioFCBClpSiz; long ioFCBParID; }; typedef struct FCBPBRec FCBPBRec; typedef FCBPBRec * FCBPBPtr;

Поля

`qLink`	Указатель на следующую запись в очереди файлового ввода-вывода. (Это поле используется внутренне Файловым менеджером для отслеживания асинхронные вызовы, ждущие выполнения.
`qType`	Тип очереди. Это поле используется внутренне Файловым менеджером.
`ioTrap`	Число прерывания вызванной функции. Это поле используется внутренне Файловым менеджером.
`ioCmdAddr`	Адрес вызванной функции. Это поле используется внутренне Файловым менеджером.
`ioCompletion`	Универсальный указатель процедуры на подпрограмму завершения, которая будет выполняться в конце асинхронного вызова. Это должно быть 0 для асинхронных вызовов без подпрограммы завершения и автоматически установлено в 0 для всех синхронных вызовов. Посмотрите `IOCompletionProcPtr` для получения информации о подпрограммах завершения.
`ioResult`	Код результата функции. Для синхронных вызовов это поле совпадает с кодом результата самого вызова функции. Для определения, когда асинхронный вызов был фактически завершен приложение может опросить это поле, это установлено в положительное число, когда вызов выполняется и получает фактический код результата, когда завершается вызов.
`ioNamePtr`	Указатель на путь. Каждый раз, когда функциональное описание указывает это `ioNamePtr` используется — очень важно ли для ввода, вывода или обоих — чтобы Вы установили это поле для указания на хранение для a `Str255` значение (если Вы используете путь), или к `NULL` (если Вы не).
`ioVRefNum`	Ссылочный номер объема, 0 для объема по умолчанию или числа диска.
`ioRefNum`	Число ссылки на файл открытого файла.
`filler`	Зарезервированный.
`ioFCBIndx`	Индекс для использования с `PBGetFCBInfoSync` и `PBGetFCBInfoAsync` функции.
`filler1`	Зарезервированный.
`ioFCBFlNm`	Идентификатор файла.
`ioFCBFlags`	Флаги, описывающие состояние файла. См. Флаги FCB для значений битов в этом поле.
`ioFCBStBlk`	Число первого блока выделения файла.
`ioFCBEOF`	Логическая длина (логический конец файла) файла.
`ioFCBPLen`	Физическая длина (физический конец файла) файла.
`ioFCBCrPs`	Текущая позиция метки файла.
`ioFCBVRefNum`	Ссылочный номер объема.
`ioFCBClpSiz`	Размер глыбы файла.
`ioFCBParID`	Родительский каталог файла ID.

Обсуждение

Низкоуровневая функция HFS PBGetFCBInfo использует блок параметра блока управления файлом, определенный FCBPBRec тип данных.

Доступность

Доступный в OS X v10.0 и позже.

Не доступный 64-разрядным приложениям.


      
      FIDParam

Определяет блок параметра, используемый низкоуровневыми функциями идентификатора файла HFS.

Объявление

Objective C

struct FIDParam { QElemPtr qLink; short qType; short ioTrap; Ptr ioCmdAddr; IOCompletionUPP ioCompletion; volatile OSErr ioResult; StringPtr ioNamePtr; short ioVRefNum; long filler14; StringPtr ioDestNamePtr; long filler15; long ioDestDirID; long filler16; long filler17; long ioSrcDirID; short filler18; long ioFileID; }; typedef struct FIDParam FIDParam; typedef FIDParam * FIDParamPtr;

Поля

`qLink`	Указатель на следующую запись в очереди файлового ввода-вывода. (Это поле используется внутренне Файловым менеджером для отслеживания асинхронные вызовы, ждущие выполнения.
`qType`	Тип очереди. Это поле используется внутренне Файловым менеджером.
`ioTrap`	Число прерывания вызванной функции. Это поле используется внутренне Файловым менеджером.
`ioCmdAddr`	Адрес вызванной функции. Это поле используется внутренне Файловым менеджером.
`ioCompletion`	Универсальный указатель процедуры на подпрограмму завершения, которая будет выполняться в конце асинхронного вызова. Это должно быть 0 для асинхронных вызовов без подпрограммы завершения и автоматически установлено в 0 для всех синхронных вызовов. Посмотрите `IOCompletionProcPtr` для получения информации о подпрограммах завершения.
`ioResult`	Код результата функции. Для синхронных вызовов это поле совпадает с кодом результата самого вызова функции. Для определения, когда асинхронный вызов был фактически завершен приложение может опросить это поле, это установлено в положительное число, когда вызов выполняется и получает фактический код результата, когда завершается вызов.
`ioNamePtr`	Указатель на путь. Каждый раз, когда функциональное описание указывает это `ioNamePtr` используется — очень важно ли для ввода, вывода или обоих — чтобы Вы установили это поле для указания на хранение для a `Str255` значение (если Вы используете путь), или к `NULL` (если Вы не).
`ioVRefNum`	Ссылочный номер объема, 0 для объема по умолчанию или числа диска.
`filler14`	Зарезервированный.
`ioDestNamePtr`	Указатель на имя целевого файла.
`filler15`	Зарезервированный.
`ioDestDirID`	Родительский каталог ID целевого файла.
`filler16`	Зарезервированный.
`filler17`	Зарезервированный.
`ioSrcDirID`	Родительский каталог ID исходного файла.
`filler18`	Зарезервированный.
`ioFileID`	Идентификатор файла.

Доступность

Доступный в OS X v10.0 и позже.

Не доступный 64-разрядным приложениям.


      
      FileParam

Определяет блок параметра, используемый низкоуровневыми функциями для получения и установки информации о файле.

Объявление

Objective C

struct FileParam { QElemPtr qLink; short qType; short ioTrap; Ptr ioCmdAddr; IOCompletionUPP ioCompletion; volatile OSErr ioResult; StringPtr ioNamePtr; short ioVRefNum; short ioFRefNum; SInt8 ioFVersNum; SInt8 filler1; short ioFDirIndex; SInt8 ioFlAttrib; SInt8 ioFlVersNum; FInfo ioFlFndrInfo; unsigned long ioFlNum; unsigned short ioFlStBlk; long ioFlLgLen; long ioFlPyLen; unsigned short ioFlRStBlk; long ioFlRLgLen; long ioFlRPyLen; unsigned long ioFlCrDat; unsigned long ioFlMdDat; }; typedef struct FileParam FileParam; typedef FileParam * FileParamPtr;

Поля

`qLink`	Указатель на следующую запись в очереди файлового ввода-вывода. (Это поле используется внутренне Файловым менеджером для отслеживания асинхронные вызовы, ждущие выполнения.
`qType`	Тип очереди. Это поле используется внутренне Файловым менеджером.
`ioTrap`	Число прерывания вызванной функции. Это поле используется внутренне Файловым менеджером.
`ioCmdAddr`	Адрес вызванной функции. Это поле используется внутренне Файловым менеджером.
`ioCompletion`	Универсальный указатель процедуры на подпрограмму завершения, которая будет выполняться в конце асинхронного вызова. Это должно быть 0 для асинхронных вызовов без подпрограммы завершения и автоматически установлено в 0 для всех синхронных вызовов. Посмотрите `IOCompletionProcPtr` для получения информации о подпрограммах завершения.
`ioResult`	Код результата функции. Для синхронных вызовов это поле совпадает с кодом результата самого вызова функции. Для определения, когда асинхронный вызов был фактически завершен приложение может опросить это поле, это установлено в положительное число, когда вызов выполняется и получает фактический код результата, когда завершается вызов.
`ioNamePtr`	Указатель на путь. Каждый раз, когда функциональное описание указывает это `ioNamePtr` используется — очень важно ли для ввода, вывода или обоих — чтобы Вы установили это поле для указания на хранение для a `Str255` значение (если Вы используете путь), или к `NULL` (если Вы не).
`ioVRefNum`	Ссылочный номер объема, 0 для объема по умолчанию или числа диска.
`ioFRefNum`	Число ссылки на файл открытого файла.
`ioFVersNum`	Номер версии файла. Это поле больше не используется. Номера версии файла являются артефактом устаревшего MFS и не поддерживаются на объемах HFS. Необходимо всегда устанавливать это поле в 0.
`filler1`	Зарезервированный.
`ioFDirIndex`	Индекс каталога для использования с `PBHGetFInfoSync` и `PBHGetFInfoAsync` функции.
`ioFlAttrib`	Атрибуты файла. Посмотрите Константы Атрибута файла для значения битов в этом поле.
`ioFlVersNum`	Номер версии файла. Эта функция больше не поддерживается, и необходимо всегда устанавливать это поле в 0.
`ioFlFndrInfo`	Информация используется Средством поиска.
`ioFlNum`	Идентификатор файла.
`ioFlStBlk`	Первый блок выделения ветви данных. Если ветвь данных файла пуста, это поле содержит 0.
`ioFlLgLen`	Логическая длина (логический конец файла) ветви данных.
`ioFlPyLen`	Физическая длина (физический конец файла) ветви данных.
`ioFlRStBlk`	Первый блок выделения ветви ресурсов. Если ветвь ресурсов файла пуста, это поле содержит 0.
`ioFlRLgLen`	Логическая длина (логический конец файла) ветви ресурсов.
`ioFlRPyLen`	Физическая длина (физический конец файла) ветви ресурсов.
`ioFlCrDat`	Дата и время создания файла, указанного в секундах с полуночи, 1 января 1904.
`ioFlMdDat`	Дата и время последнего изменения к файлу, указанному в секундах с полуночи, 1 января 1904.

Доступность

Доступный в OS X v10.0 и позже.

Не доступный 64-разрядным приложениям.

FNSubscriptionRef FNSubscriptionRef

Объявление

Swift

typealias FNSubscriptionRef = FNSubscription

Objective C

typedef struct OpaqueFNSubscriptionRef * FNSubscriptionRef;

Оператор импорта

Objective C

@import CoreServices;

Swift

import CoreServices

Доступность

Доступный в OS X v10.1 и позже.
FNSubscriptionUPP FNSubscriptionUPP

Объявление

Swift

typealias FNSubscriptionUPP = FNSubscriptionProcPtr

Objective C

typedef FNSubscriptionProcPtr FNSubscriptionUPP;

Оператор импорта

Objective C

@import CoreServices;

Swift

import CoreServices

Доступность

Доступный в OS X v10.1 и позже.


      
      ForeignPrivParam

Определяет блок параметра, используемый низкоуровневым HFS внешние функции полномочий.

Объявление

Objective C

struct ForeignPrivParam { QElemPtr qLink; short qType; short ioTrap; Ptr ioCmdAddr; IOCompletionUPP ioCompletion; volatile OSErr ioResult; StringPtr ioNamePtr; short ioVRefNum; long ioFiller21; long ioFiller22; Ptr ioForeignPrivBuffer; long ioForeignPrivActCount; long ioForeignPrivReqCount; long ioFiller23; long ioForeignPrivDirID; long ioForeignPrivInfo1; long ioForeignPrivInfo2; long ioForeignPrivInfo3; long ioForeignPrivInfo4; }; typedef struct ForeignPrivParam ForeignPrivParam; typedef ForeignPrivParam * ForeignPrivParamPtr;

Поля

`qLink`	Указатель на следующую запись в очереди файлового ввода-вывода. (Это поле используется внутренне Файловым менеджером для отслеживания асинхронные вызовы, ждущие выполнения.
`qType`	Тип очереди. Это поле используется внутренне Файловым менеджером.
`ioTrap`	Число прерывания вызванной функции. Это поле используется внутренне Файловым менеджером.
`ioCmdAddr`	Адрес вызванной функции. Это поле используется внутренне Файловым менеджером.
`ioCompletion`	Универсальный указатель процедуры на подпрограмму завершения, которая будет выполняться в конце асинхронного вызова. Это должно быть 0 для асинхронных вызовов без подпрограммы завершения и автоматически установлено в 0 для всех синхронных вызовов. Посмотрите `IOCompletionProcPtr` для получения информации о подпрограммах завершения.
`ioResult`	Код результата функции. Для синхронных вызовов это поле совпадает с кодом результата самого вызова функции. Для определения, когда асинхронный вызов был фактически завершен приложение может опросить это поле, это установлено в положительное число, когда вызов выполняется и получает фактический код результата, когда завершается вызов.
`ioNamePtr`	Указатель на путь. Каждый раз, когда функциональное описание указывает это `ioNamePtr` используется — очень важно ли для ввода, вывода или обоих — чтобы Вы установили это поле для указания на хранение для a `Str255` значение (если Вы используете путь), или к `NULL` (если Вы не).
`ioVRefNum`	Ссылочный номер объема, 0 для объема по умолчанию или числа диска.
`ioFiller21`	Зарезервированный.
`ioFiller22`	Зарезервированный.
`ioForeignPrivBuffer`	Указатель на буферное, содержащее информацию о контроле доступа о внешней файловой системе.
`ioForeignPrivActCount`	Размер буфера, на который указывают `ioForeignPrivBuffer` поле.
`ioForeignPrivReqCount`	Сумма буфера, на который указывают `ioForeignPrivBuffer` поле, фактически использовавшееся для содержания данных.
`ioFiller23`	Зарезервированный.
`ioForeignPrivDirID`	Родительский каталог ID внешнего файла или каталога.
`ioForeignPrivInfo1`	Длинное слово, которое может содержать данные полномочий.
`ioForeignPrivInfo2`	Длинное слово, которое может содержать данные полномочий.
`ioForeignPrivInfo3`	Длинное слово, которое может содержать данные полномочий.
`ioForeignPrivInfo4`	Длинное слово, которое может содержать данные полномочий.

Доступность

Доступный в OS X v10.0 и позже.

Не доступный 64-разрядным приложениям.


      
      FSCatalogBulkParam

Определяет блок параметра, используемый для получения информации о каталоге оптом о HFS Плюс объемы.

Объявление

Swift

struct FSCatalogBulkParam { var qLink: QElemPtr var qType: Int16 var ioTrap: Int16 var ioCmdAddr: Ptr var ioCompletion: IOCompletionUPP var ioResult: OSErr var containerChanged: Boolean var reserved: UInt8 var iteratorFlags: FSIteratorFlags var iterator: FSIterator var container: UnsafePointer<FSRef> var maximumItems: ItemCount var actualItems: ItemCount var whichInfo: FSCatalogInfoBitmap var catalogInfo: UnsafeMutablePointer<FSCatalogInfo> var refs: UnsafeMutablePointer<FSRef> var specs: FSSpecPtr var names: UnsafeMutablePointer<HFSUniStr255> var searchParams: UnsafePointer<FSSearchParams> }

Objective C

struct FSCatalogBulkParam { QElemPtr qLink; short qType; short ioTrap; Ptr ioCmdAddr; IOCompletionUPP ioCompletion; volatile OSErr ioResult; Boolean containerChanged; UInt8 reserved; FSIteratorFlags iteratorFlags; FSIterator iterator; const FSRef * container; ItemCount maximumItems; ItemCount actualItems; FSCatalogInfoBitmap whichInfo; FSCatalogInfo * catalogInfo; FSRef * refs; FSSpec * specs; HFSUniStr255 * names; const FSSearchParams * searchParams; }; typedef struct FSCatalogBulkParam FSCatalogBulkParam; typedef FSCatalogBulkParam * FSCatalogBulkParamPtr;

Поля

`qLink`	Указатель на следующую запись в очереди файлового ввода-вывода. (Это поле используется внутренне Файловым менеджером для отслеживания асинхронные вызовы, ждущие выполнения.
`qType`	Тип очереди. Это поле используется внутренне Файловым менеджером.
`ioTrap`	Число прерывания вызванной функции. Это поле используется внутренне Файловым менеджером.
`ioCmdAddr`	Адрес вызванной функции. Это поле используется внутренне Файловым менеджером.
`ioCompletion`	Универсальный указатель процедуры на подпрограмму завершения, которая будет выполняться в конце асинхронного вызова. Это должно быть 0 для асинхронных вызовов без подпрограммы завершения и автоматически установлено в 0 для всех синхронных вызовов. Посмотрите `IOCompletionProcPtr` для получения информации о подпрограммах завершения.
`ioResult`	Код результата функции. Для синхронных вызовов это поле совпадает с кодом результата самого вызова функции. Для определения, когда асинхронный вызов был фактически завершен приложение может опросить это поле, это установлено в положительное число, когда вызов выполняется и получает фактический код результата, когда завершается вызов.
`containerChanged`	Булево значение, указывающее, изменился ли контейнер начиная с последней возможности на `PBGetCatalogInfoBulkSync` или `PBGetCatalogInfoBulkAsync`.
`reserved`	Зарезервированный.
`iteratorFlags`	Ряд отмечает, который указывает, как итератор должен выполнить итерации по контейнеру. Посмотрите Флаги Итератора для значения констант, используемых здесь.
`iterator`	Итератор каталога.
`container`	`FSRef` для каталога или объема для итерации.
`maximumItems`	Максимальное количество элементов для возврата информации о.
`actualItems`	Фактическое число элементов возвратилось.
`whichInfo`	Битовый массив, указывающий, который поля информационной структуры каталога возвратиться. Посмотрите Растровые Константы информации о Каталоге для битов, определенных для этого поля.
`catalogInfo`	Указатель на массив информационных структур каталога. На вводе необходимо передать указатель на массив `maximumItemsFSCatalogInfo` структуры. По возврату, `actualItems` структуры будут заполнены требуемой информацией в `whichInfo` поле. Если Вы не хотите, чтобы информация о каталоге была возвращена, передайте a `NULL` указатель в этом поле и передаче константа `kFSCatInfoNone` в `whichInfo` поле.
`refs`	Указатель на массив `FSRef` структуры. На вводе необходимо передать указатель на `maximumItemsFSRef` структуры. По возврату, `actualItems` структуры будут заполнены. Если Вы не желаете никому `FSRef` структуры, которые будут возвращены, передайте a `NULL` указатель в этом поле.
`specs`	Указатель на массив `FSSpec` структуры. На вводе необходимо передать указатель на `maximumItems` спецификации файловой системы. По возврату, `actualItemsFSSpec` структуры будут заполнены в. Если Вы не желаете никому `FSSpec` информация, которая будет возвращена, передайте a `NULL` указатель в этом поле.
`names`	Указатель на массив имен Unicode. На вводе необходимо передать указатель на массив `maximumItemsHFSUniStr255` структуры. По возврату, `actualItems` структуры будут содержать имена Unicode. Если Вы не хотите, чтобы какие-либо имена файла или каталога были возвращены, передайте a `NULL` указатель в этом поле.
`searchParams`	Указатель на `FSSearchParams` структура, указывая значения для соответствия против.

Доступность

Доступный в OS X v10.0 и позже.


      
      FSCatalogInfo

Содержит основную информацию о файле или каталоге.

Объявление

Swift

struct FSCatalogInfo { var nodeFlags: UInt16 var volume: FSVolumeRefNum var parentDirID: UInt32 var nodeID: UInt32 var sharingFlags: UInt8 var userPrivileges: UInt8 var reserved1: UInt8 var reserved2: UInt8 var createDate: UTCDateTime var contentModDate: UTCDateTime var attributeModDate: UTCDateTime var accessDate: UTCDateTime var backupDate: UTCDateTime var permissions: FSPermissionInfo var finderInfo: (UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8) var extFinderInfo: (UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8) var dataLogicalSize: UInt64 var dataPhysicalSize: UInt64 var rsrcLogicalSize: UInt64 var rsrcPhysicalSize: UInt64 var valence: UInt32 var textEncodingHint: TextEncoding }

Objective C

struct FSCatalogInfo { UInt16 nodeFlags; FSVolumeRefNum volume; UInt32 parentDirID; UInt32 nodeID; UInt8 sharingFlags; UInt8 userPrivileges; UInt8 reserved1; UInt8 reserved2; UTCDateTime createDate; UTCDateTime contentModDate; UTCDateTime attributeModDate; UTCDateTime accessDate; UTCDateTime backupDate; UInt32 permissions[4]; UInt8 finderInfo[16]; UInt8 extFinderInfo[16]; UInt64 dataLogicalSize; UInt64 dataPhysicalSize; UInt64 rsrcLogicalSize; UInt64 rsrcPhysicalSize; UInt32 valence; TextEncoding textEncodingHint; }; typedef struct FSCatalogInfo FSCatalogInfo; typedef FSCatalogInfo * FSCatalogInfoPtr;

Поля

`nodeFlags`	Флаги узла. Это поле имеет два определенных бита, указывающие, является ли объект файлом или папкой, и заблокирован ли файл (константы `kFSNodeIsDirectoryMask` и `kFSNodeLockedMask`). Посмотрите Флаги Узла информации о Каталоге для значений, которые можно использовать здесь.
`volume`	Ссылка объема объекта.
`parentDirID`	ID каталога, содержащего данный объект. Корневой каталог объема всегда имеет ID `fsRtDirID` (2); родителем корневого каталога является ID `fsRtParID` (1). Обратите внимание на то, что нет никакого объекта с ID `fsRtParID`; когда Файловый менеджер просят относительно родителя корневого каталога, это просто используется.
`nodeID`	Файл или каталог ID.
`sharingFlags`	Совместное использование объекта флагов. Посмотрите Флаги Совместного пользования информацией Каталога для значения битов, определенных для этого поля.
`userPrivileges`	Эффективные полномочия AFP пользователя (то же как `ioACUser` в старом `HFileInfo` и `DirInfo` структуры). Посмотрите Константы Полномочий пользователя.
`reserved1`	Зарезервированный.
`reserved2`	Зарезервированный.
`createDate`	Дата и время создания объекта. Обратите внимание на то, что файловые системы кроме AFP, HFS и HFS Плюс обычно не поддерживают даты создания. Для файловых систем, не поддерживающих даты создания, `FSGetCatalogInfo`, `PBGetCatalogInfoSync`, и `PBGetCatalogInfoAsync` возвратитесь 0 в этом поле.
`contentModDate`	Дата и время, что были в последний раз изменены ветвь данных или ветвь ресурсов.
`attributeModDate`	Дата и время, что был в последний раз изменен атрибут объекта (такого как ветвление кроме ветви данных или ветви ресурсов).
`accessDate`	Дата и время, что к объекту в последний раз получили доступ. Mac OS 9 Файловых менеджеров автоматически не обновляет `accessDate` поле; это существует прежде всего для использования другими операционными системами (особенно OS X).
`backupDate`	Дата и время последнего резервного копирования объекта. Это поле не обновляется Файловым менеджером, утилита резервного копирования может использовать это поле, если это желает. Обратите внимание на то, что файловые системы кроме AFP, HFS и HFS Плюс обычно не поддерживают резервные даты. Для файловых систем, не поддерживающих резервные даты, `FSGetCatalogInfo`, `PBGetCatalogInfoSync`, и `PBGetCatalogInfoAsync` возвратитесь 0 в этом поле.
`permissions`	Пользователь и данные полномочий группы. Mac OS 8 и 9 Файловых менеджеров не использует или осуществляет эти данные полномочий. Это могло использоваться программой файлового сервера или другой операционной системой (прежде всего OS X). В OS X этот массив содержит полномочия файловой системы возвращенного элемента. Для использования этой информации принудите параметр к a `FSPermissionInfo` структура.
`finderInfo`	Основная информация о Средстве поиска для объекта. Эта информация доступна в информации о каталоге, вместо в именованном ветвлении, по историческим причинам. Файловый менеджер не интерпретирует содержание этих полей. Для использования этой информации принудите параметр к a `FileInfo` или `FolderInfo` структура.
`extFinderInfo`	Расширенная информация о Средстве поиска для объекта. Эта информация доступна в информации о каталоге, вместо в именованном ветвлении, по историческим причинам. Файловый менеджер не интерпретирует содержание этих полей. Для использования этой информации принудите параметр к `ExtendedFileInfo` или `ExtendedFolderInfo` структура.
`dataLogicalSize`	Размер ветви данных в байтах (логический размер ветвления). Информация в этом поле только допустима для файлов, не полагаются на значение, возвращенное в этом поле для папок.
`dataPhysicalSize`	Сумма дискового пространства, в байтах, занятых по условию ветвление (физический размер ветвления). Информация в этом поле только допустима для файлов, не полагаются на значение, возвращенное в этом поле для папок.
`rsrcLogicalSize`	Размер ветви ресурсов (логический размер ветвления). Информация в этом поле только допустима для файлов, не полагаются на значение, возвращенное в этом поле для папок.
`rsrcPhysicalSize`	Сумма дискового пространства, занятого ветвью ресурсов (физический размер ветвления). Информация в этом поле только допустима для файлов, не полагаются на значение, возвращенное в этом поле для папок.
`valence`	Для папок только, числа элементов (файлы плюс каталоги) содержавший в каталоге. Для файлов это обнуляется. Много форматов объема не хранят поле, содержащее валентность каталога. Для тех форматов объема это поле является очень дорогим для вычислений. Думайте тщательно, прежде чем Вы попросите, чтобы Файловый менеджер возвратил это поле.
`textEncodingHint`	`textEncodingHint` поле используется в сочетании с именем файла Unicode объекта. Это - дополнительная подсказка, которая может использоваться форматом объема при преобразовании Unicode в некоторое другое кодирование. Например, HFS Плюс хранилища это значение и использование это при преобразовании имени к кодированию Mac OS, такой как тогда, когда имя возвращается `PBGetCatInfoSync` или `PBGetCatInfoAsync`. Как другой пример, объемы HFS используют это значение для преобразования имени Unicode к закодированному имени Mac OS, сохраненному на диске. Если все имя Unicode может быть преобразовано в единственное кодирование Mac OS, то то кодирование должно использоваться в качестве `textEncodingHint`; иначе, текстовое кодирование, соответствующее первым символам имени, вероятно, обеспечит лучший пользовательский опыт. Если a `textEncodingHint` не предоставляется, когда файл или каталог будет создан или переименован, формат объема будет использовать значение по умолчанию. Это значение по умолчанию может не быть самым лучшим выбором для данного имени файла. Каждый раз, когда возможно, клиент должен предоставить a `textEncodingHint`.

Обсуждение

FSCatalogInfoBitmap тип используется для указания который поля FSCatalogInfo должен быть установлен или получен. Если бит, соответствующий определенному полю, не установлен, то то поле не изменяется если FSCatalogInfo выходной параметр, и то поле проигнорировано если FSCatalogInfo входной параметр.

Доступность

Доступный в OS X v10.0 и позже.

FSCatalogInfoBitmap FSCatalogInfoBitmap

Описывает который поля FSCatalogInfo структура Вы хотите получить или установить.

Объявление

Swift

typealias FSCatalogInfoBitmap = UInt32

Objective C

typedef UInt32 FSCatalogInfoBitmap;

Обсуждение

Если бит, соответствующий определенному полю, не установлен в битовом массиве, то то поле не изменяется в FSCatalogInfo структура, если это - выходной параметр и то поле, проигнорирована если FSCatalogInfo структура является входным параметром. Посмотрите Растровые Константы информации о Каталоге для описания констант, которые необходимо использовать с этим типом данных.

Оператор импорта

Objective C

@import CoreServices;

Swift

import CoreServices

Доступность

Доступный в OS X v10.0 и позже.
FSEjectStatus FSEjectStatus

Объявление

Swift

typealias FSEjectStatus = UInt32

Objective C

typedef UInt32 FSEjectStatus;

Оператор импорта

Objective C

@import CoreServices;

Swift

import CoreServices

Доступность

Доступный в OS X v10.2 и позже.


      
      FSFileOperationClientContext

Указывает определяемые пользователем данные и обратные вызовы, связанные с асинхронной работой файла.

Объявление

Swift

struct FSFileOperationClientContext { var version: CFIndex var info: UnsafeMutablePointer<Void> var retain: CFAllocatorRetainCallBack var release: CFAllocatorReleaseCallBack var copyDescription: CFAllocatorCopyDescriptionCallBack }

Objective C

struct FSFileOperationClientContext { CFIndex version; void *info; CFAllocatorRetainCallBack retain; CFAllocatorReleaseCallBack release; CFAllocatorCopyDescriptionCallBack copyDescription; }; typedef struct FSFileOperationClientContext FSFileOperationClientContext;

Поля

`version`	Номер версии структуры; это поле должно всегда содержать 0.
`info`	Универсальный указатель на Ваши определяемые пользователем данные. Этот указатель пасуется назад к Вашему приложению при проверке состояния работы файла. Существует два способа, которыми можно попросить у Файлового менеджера информации о статусе о работе файла: путем предоставления функции обратного вызова состояния, когда Вы запускаете работу, или путем вызывания функции состояния работы файла непосредственно.
`retain`	Дополнительная функция обратного вызова, которую Файловый менеджер может использовать для сохранения определяемых пользователем данных, указанных в `info` параметр. Если Ваши данные являются Базовым объектом Основы, можно просто указать функцию `CFRetain`. Если никакой обратный вызов не необходим, установите это поле в `NULL`.
`release`	Дополнительная функция обратного вызова, которую Файловый менеджер может использовать для выпуска определяемых пользователем данных, указанных в `info` параметр. Если Ваши данные являются Базовым объектом Основы, можно просто указать функцию `CFRelease`. Если никакой обратный вызов не необходим, установите это поле в `NULL`.
`copyDescription`	Дополнительная функция обратного вызова, которую Файловый менеджер может использовать для создания представления описательной строки определяемых пользователем данных для отладки целей. Если никакой обратный вызов не необходим, установите это поле в `NULL`.

Обсуждение

Вы предоставляете клиентский контекст при вызывании функций такой как FSCopyObjectAsync или FSMoveObjectAsync тот запуск асинхронная копия или операция пересылки.

Доступность

Доступный в OS X v10.4 и позже.

FSFileOperationRef FSFileOperationRef
Определяет непрозрачный тип, представляющий асинхронную работу файла.

Объявление

Swift

typealias FSFileOperationRef = FSFileOperation

Objective C

typedef struct __FSFileOperation * FSFileOperationRef;
Обсуждение

Вы предоставляете объект операции файла при вызывании функций такой как FSCopyObjectAsync или FSMoveObjectAsync запустить асинхронную копию или операцию пересылки. Можно также использовать объект операции файла, чтобы проверить состояние работы файла или отменить работу.

Выполнять асинхронную работу файла:
1. Создайте объект операции файла с помощью функции FSFileOperationCreate.
2. Передайте объект функции FSFileOperationScheduleWithRunLoop запланировать работу.
3. Передайте объект одной из асинхронных функций работы файла для запуска работы.
FSFileOperationRef непрозрачный тип является стандартным Базовым типом данных Основы. Это получено из CFType и наследовало свойства, которые все Базовые типы Основы имеют вместе. Для получения дополнительной информации см. Ссылку CFType.
Оператор импорта

Objective C

@import CoreServices;

Swift

import CoreServices

Доступность

Доступный в OS X v10.4 и позже.


      
      FSForkCBInfoParam

Определяет блок параметра, используемый низкоуровневым HFS Плюс функции блока управления ветвления.

Объявление

Swift

struct FSForkCBInfoParam { var qLink: QElemPtr var qType: Int16 var ioTrap: Int16 var ioCmdAddr: Ptr var ioCompletion: IOCompletionUPP var ioResult: OSErr var desiredRefNum: FSIORefNum var volumeRefNum: FSVolumeRefNum var iterator: FSIORefNum var actualRefNum: FSVolumeRefNum var ref: UnsafeMutablePointer<FSRef> var forkInfo: UnsafeMutablePointer<FSForkInfo> var forkName: UnsafeMutablePointer<HFSUniStr255> }

Objective C

struct FSForkCBInfoParam { QElemPtr qLink; short qType; short ioTrap; Ptr ioCmdAddr; IOCompletionUPP ioCompletion; volatile OSErr ioResult; SInt16 desiredRefNum; SInt16 volumeRefNum; SInt16 iterator; SInt16 actualRefNum; FSRef * ref; FSForkInfo * forkInfo; HFSUniStr255 * forkName; }; typedef struct FSForkCBInfoParam FSForkCBInfoParam; typedef FSForkCBInfoParam * FSForkCBInfoParamPtr;

Поля

`qLink`	Указатель на следующую запись в очереди файлового ввода-вывода. (Это поле используется внутренне Файловым менеджером для отслеживания асинхронные вызовы, ждущие выполнения.
`qType`	Тип очереди. Это поле используется внутренне Файловым менеджером.
`ioTrap`	Число прерывания вызванной функции. Это поле используется внутренне Файловым менеджером.
`ioCmdAddr`	Адрес вызванной функции. Это поле используется внутренне Файловым менеджером.
`ioCompletion`	Универсальный указатель процедуры на подпрограмму завершения, которая будет выполняться в конце асинхронного вызова. Это должно быть 0 для асинхронных вызовов без подпрограммы завершения и автоматически установлено в 0 для всех синхронных вызовов. Посмотрите `IOCompletionProcPtr` для получения информации о подпрограммах завершения.
`ioResult`	Код результата функции. Для синхронных вызовов это поле совпадает с кодом результата самого вызова функции. Для определения, когда асинхронный вызов был фактически завершен приложение может опросить это поле, это установлено в положительное число, когда вызов выполняется и получает фактический код результата, когда завершается вызов.
`desiredRefNum`	Ссылочный номер ветвления.
`volumeRefNum`	Ссылочный номер объема объема, чтобы соответствовать, или обнулить для соответствия всех объемов.
`iterator`	Итератор. Обнуленный для запуска итерации.
`actualRefNum`	По возврату найден фактический ссылочный номер ветвления.
`ref`	Указатель на `FSRef` для указанного ветвления.
`forkInfo`	Указатель на информационную структуру ветвления, `FSForkInfo`.
`forkName`	Указатель на имя Unicode ветвления.

Доступность

Доступный в OS X v10.0 и позже.


      
      FSForkInfo

Содержит информацию об открытом ветвлении.

Объявление

Swift

struct FSForkInfo { var flags: FSForkInfoFlags var permissions: Int8 var volume: FSVolumeRefNum var reserved2: UInt32 var nodeID: UInt32 var forkID: UInt32 var currentPosition: UInt64 var logicalEOF: UInt64 var physicalEOF: UInt64 var process: UInt64 }

Objective C

struct FSForkInfo { SInt8 flags; SInt8 permissions; FSVolumeRefNum volume; UInt32 reserved2; UInt32 nodeID; UInt32 forkID; UInt64 currentPosition; UInt64 logicalEOF; UInt64 physicalEOF; UInt64 process; }; typedef struct FSForkInfo FSForkInfo; typedef FSForkInfo * FSForkInfoPtr;

Поля

`flags`	Флаги, описывающие состояние ветвления. См. Флаги FCB для описания битов в этом поле.
`permissions`	Пользователь и данные полномочий группы.
`volume`	Спецификация объема. Это может быть ссылочным номером объема, числом диска, или 0 для объема по умолчанию.
`reserved2`	Зарезервированный.
`nodeID`	ID файла или каталога файла или каталога, с которым связано ветвление.
`forkID`	Ветвление ID.
`currentPosition`	Текущая позиция в ветвлении.
`logicalEOF`	Логический размер ветвления.
`physicalEOF`	Физический размер ветвления.
`process`	Процесс, открывший ветвление.

Обсуждение

Этот тип данных используется в forkInfo параметр FSGetForkCBInfo функция, и в forkInfo поле FSForkCBInfoParam блок параметра передал PBGetForkCBInfoSync и PBGetForkCBInfoAsync функции. Когда эти функции возвращаются, FSForkInfo структура содержит информацию об указанном открытом ветвлении.

Доступность

Доступный в OS X v10.0 и позже.


      
      FSForkIOParam

Определяет блок параметра, используемый низкоуровневым HFS Плюс ветвление функции I/O.

Объявление

Swift

struct FSForkIOParam { var qLink: QElemPtr var qType: Int16 var ioTrap: Int16 var ioCmdAddr: Ptr var ioCompletion: IOCompletionUPP var ioResult: OSErr var reserved1: UnsafeMutablePointer<Void> var reserved2: Int16 var forkRefNum: FSIORefNum var reserved3: UInt8 var permissions: Int8 var ref: UnsafePointer<FSRef> var buffer: Ptr var requestCount: UInt32 var actualCount: UInt32 var positionMode: UInt16 var positionOffset: Int64 var allocationFlags: FSAllocationFlags var allocationAmount: UInt64 var forkNameLength: UniCharCount var forkName: UnsafePointer<UniChar> var forkIterator: CatPositionRec var outForkName: UnsafeMutablePointer<HFSUniStr255> }

Objective C

struct FSForkIOParam { QElemPtr qLink; short qType; short ioTrap; Ptr ioCmdAddr; IOCompletionUPP ioCompletion; volatile OSErr ioResult; void * reserved1; SInt16 reserved2; SInt16 forkRefNum; UInt8 reserved3; SInt8 permissions; const FSRef * ref; Ptr buffer; UInt32 requestCount; UInt32 actualCount; UInt16 positionMode; SInt64 positionOffset; FSAllocationFlags allocationFlags; UInt64 allocationAmount; UniCharCount forkNameLength; const UniChar * forkName; CatPositionRec forkIterator; HFSUniStr255 * outForkName; }; typedef struct FSForkIOParam FSForkIOParam; typedef FSForkIOParam * FSForkIOParamPtr;

Поля

`qLink`	Указатель на следующую запись в очереди файлового ввода-вывода. (Это поле используется внутренне Файловым менеджером для отслеживания асинхронные вызовы, ждущие выполнения.
`qType`	Тип очереди. Это поле используется внутренне Файловым менеджером.
`ioTrap`	Число прерывания вызванной функции. Это поле используется внутренне Файловым менеджером.
`ioCmdAddr`	Адрес вызванной функции. Это поле используется внутренне Файловым менеджером.
`ioCompletion`	Универсальный указатель процедуры на подпрограмму завершения, которая будет выполняться в конце асинхронного вызова. Это должно быть 0 для асинхронных вызовов без подпрограммы завершения и автоматически установлено в 0 для всех синхронных вызовов. Посмотрите `IOCompletionProcPtr` для получения информации о подпрограммах завершения.
`ioResult`	Код результата функции. Для синхронных вызовов это поле совпадает с кодом результата самого вызова функции. Для определения, когда асинхронный вызов был фактически завершен приложение может опросить это поле, это установлено в положительное число, когда вызов выполняется и получает фактический код результата, когда завершается вызов.
`reserved1`	Зарезервированный.
`reserved2`	Зарезервированный.
`forkRefNum`	Ссылочный номер для ветвления.
`reserved3`	Зарезервированный.
`permissions`	Желаемый тип доступа к указанному ветвлению. Посмотрите Константы Разрешения Доступа к файлу для описания типов доступа, который можно запросить.
`ref`	`FSRef` для файла или каталога для открытия.
`buffer`	Указатель на буфер данных.
`requestCount`	Число байтов требуют на данную работу.
`actualCount`	Фактическое число байтов, завершенных вызовом.
`positionMode`	Постоянное указание основного расположения в файле для запуска работы. Посмотрите Константы Режима Позиции для значения констант, которые можно использовать в этом поле.
`positionOffset`	Смещение от основного расположения, указанного в `positionMode` смещение для запуска работы.
`allocationFlags`	Ряд битовых флагов, используемых `FSAllocateFork` функционируйте, чтобы управлять, как выделена площадь. Посмотрите Флаги Выделения для описания определенных флагов.
`allocationAmount`	Для `FSAllocateFork` функция, сумма пространства, в байтах, для выделения.
`forkNameLength`	Длина имени файла или каталога передала в `forkName` поле, в символах Unicode.
`forkName`	Указатель на имя Unicode файла или каталога. Это поле является входными функциями параметра, какой возврат имя файла или каталога в блоке параметра использует `outForkName` поле.
`forkIterator`	Итератор ветвления.
`outForkName`	Указатель на Unicode файла или каталога называет, это - выходной параметр. Для функций, требующих имени файла или каталога как входного аргумента, необходимо передать указатель на то имя в `forkName` поле и передача длина имени в `forkNameLength` поле.

Доступность

Доступный в OS X v10.0 и позже.

FSIterator FSIterator

Относится к позиции в каталоге, используемом при итерации по файлам и папкам в каталоге.

Объявление

Swift

typealias FSIterator = COpaquePointer

Objective C

typedef struct OpaqueFSIterator * FSIterator;

Обсуждение

Этот тип данных походит на число ссылки на файл, потому что он поддерживает состояние внутренне к Файловому менеджеру и должен быть явно открыт и закрыт.

FSIterator возвращается FSOpenIterator и передается как ввод FSGetCatalogInfoBulk , FSCatalogSearch и FSCloseIterator .

Оператор импорта

Objective C

@import CoreServices;

Swift

import CoreServices

Доступность

Доступный в OS X v10.0 и позже.
FSMountStatus FSMountStatus

Объявление

Swift

typealias FSMountStatus = UInt32

Objective C

typedef UInt32 FSMountStatus;

Оператор импорта

Objective C

@import CoreServices;

Swift

import CoreServices

Доступность

Доступный в OS X v10.2 и позже.
FSPermissionInfo

Объявление

Swift

struct FSPermissionInfo { var userID: UInt32 var groupID: UInt32 var reserved1: UInt8 var userAccess: UInt8 var mode: UInt16 var fileSec: Unmanaged<FSFileSecurity>! }

Objective C

struct FSPermissionInfo { UInt32 userID; UInt32 groupID; UInt8 reserved1; UInt8 userAccess; UInt16 mode; UInt32 reserved2; }; typedef struct FSPermissionInfo FSPermissionInfo;

Доступность

Доступный в OS X v10.0 и позже.
FSRangeLockParam

Определяет блок параметра для использования с 64-разрядными функциями блокировки диапазона.

Объявление

Swift

struct FSRangeLockParam { var qLink: QElemPtr var qType: Int16 var ioTrap: Int16 var ioCmdAddr: Ptr var ioCompletion: IOCompletionUPP var ioResult: OSErr var forkRefNum: FSIORefNum var requestCount: UInt64 var positionMode: UInt16 var positionOffset: Int64 var rangeStart: UInt64 }

Objective C

struct FSRangeLockParam { QElemPtr qLink; SInt16 qType; SInt16 ioTrap; Ptr ioCmdAddr; IOCompletionUPP ioCompletion; volatile OSErr ioResult; FSIORefNum forkRefNum; UInt64 requestCount; UInt16 positionMode; SInt64 positionOffset; UInt64 rangeStart; }; typedef struct FSRangeLockParam FSRangeLockParam;

Доступность

Доступный в OS X v10.4 и позже.
FSRangeLockParamPtr FSRangeLockParamPtr

Определяет указатель на блок параметра блокировки диапазона.

Объявление

Swift

typealias FSRangeLockParamPtr = UnsafeMutablePointer<FSRangeLockParam>

Objective C

typedef FSRangeLockParam *FSRangeLockParamPtr;

Оператор импорта

Objective C

@import CoreServices;

Swift

import CoreServices

Доступность

Доступный в OS X v10.4 и позже.
FSRef

Идентифицирует каталог или файл, включая корневой каталог объема.

Объявление

Swift

struct FSRef { var hidden: (UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8) }

Objective C

struct FSRef { UInt8 hidden[80]; }; typedef struct FSRef FSRef; typedef FSRef * FSRefPtr;

Обсуждение

Цель этого типа данных подобна FSSpec за исключением того, что FSRef абсолютно непрозрачно. FSRef содержит любую информацию, необходим для нахождения данного объекта; внутренняя структура FSRef вероятно, будет варьироваться на основе формата объема и может варьироваться на основе определенного идентифицируемого объекта.

Клиент Файлового менеджера не может исследовать содержание FSRef извлечь информацию о родительском каталоге или имени объекта. Точно так же FSRef не может быть создан непосредственно клиентом; FSRef должен быть создан и возвращен через Файловый менеджер. Нет никакой потребности вызвать Файловый менеджер для расположения FSRef.

Для определения объема родительский каталог и имя связались с FSRef, или получить эквивалент FSSpec, используйте FSGetCatalogInfo вызвать.

Доступность

Доступный в OS X v10.0 и позже.


      
      FSRefParam

Определяет блок параметра, используемый низкоуровневым HFS Плюс функции.

Объявление

Swift

struct FSRefParam { var qLink: QElemPtr var qType: Int16 var ioTrap: Int16 var ioCmdAddr: Ptr var ioCompletion: IOCompletionUPP var ioResult: OSErr var ioNamePtr: ConstStringPtr var ioVRefNum: FSVolumeRefNum var reserved1: Int16 var reserved2: UInt8 var reserved3: UInt8 var ref: UnsafePointer<FSRef> var whichInfo: FSCatalogInfoBitmap var catInfo: UnsafeMutablePointer<FSCatalogInfo> var nameLength: UniCharCount var name: UnsafePointer<UniChar> var ioDirID: UInt32 var spec: FSSpecPtr var parentRef: UnsafeMutablePointer<FSRef> var newRef: UnsafeMutablePointer<FSRef> var textEncodingHint: TextEncoding var outName: UnsafeMutablePointer<HFSUniStr255> }

Objective C

struct FSRefParam { QElemPtr qLink; short qType; short ioTrap; Ptr ioCmdAddr; IOCompletionUPP ioCompletion; volatile OSErr ioResult; ConstStringPtr ioNamePtr; short ioVRefNum; SInt16 reserved1; UInt8 reserved2; UInt8 reserved3; const FSRef * ref; FSCatalogInfoBitmap whichInfo; FSCatalogInfo * catInfo; UniCharCount nameLength; const UniChar * name; long ioDirID; FSSpec * spec; FSRef * parentRef; FSRef * newRef; TextEncoding textEncodingHint; HFSUniStr255 * outName; }; typedef struct FSRefParam FSRefParam; typedef FSRefParam * FSRefParamPtr;

Поля

`qLink`	Указатель на следующую запись в очереди файлового ввода-вывода. (Это поле используется внутренне Файловым менеджером для отслеживания асинхронные вызовы, ждущие выполнения.
`qType`	Тип очереди. Это поле используется внутренне Файловым менеджером.
`ioTrap`	Число прерывания вызванной функции. Это поле используется внутренне Файловым менеджером.
`ioCmdAddr`	Адрес вызванной функции. Это поле используется внутренне Файловым менеджером.
`ioCompletion`	Универсальный указатель процедуры на подпрограмму завершения, которая будет выполняться в конце асинхронного вызова. Это должно быть 0 для асинхронных вызовов без подпрограммы завершения и автоматически установлено в 0 для всех синхронных вызовов. Посмотрите `IOCompletionProcPtr` для получения информации о подпрограммах завершения.
`ioResult`	Код результата функции. Для синхронных вызовов это поле совпадает с кодом результата самого вызова функции. Для определения, когда асинхронный вызов был фактически завершен приложение может опросить это поле, это установлено в положительное число, когда вызов выполняется и получает фактический код результата, когда завершается вызов.
`ioNamePtr`	Указатель на путь. Каждый раз, когда функциональное описание указывает это `ioNamePtr` используется — необходимо ли для ввода, вывода или обоих — установить это поле для указания на хранение для a `Str255` значение (если Вы используете путь), или к `NULL` (если Вы не).
`ioVRefNum`	Ссылочный номер объема, или 0 для объема по умолчанию.
`reserved1`	Зарезервированный.
`reserved2`	Зарезервированный.
`reserved3`	Зарезервированный.
`ref`	`FSRef` описание файла или каталога, который является целью вызова.
`whichInfo`	`FSCatalogInfoBitmap` то, которое описывает поля информационной структуры каталога, передало в `catInfo` поле, которые должны быть получены или установлены.
`catInfo`	Информационная структура каталога, содержащая информацию об указанном файле или каталоге.
`nameLength`	Длина имени файла или каталога, для `PBCreateSync`, `PBCreateAsync`, `PBRenameSync`, и `PBRenameAsync` функции.
`name`	Указатель на имя Unicode файла или каталога, для `PBCreateSync`, `PBCreateAsync`, `PBRenameSync`, и `PBRenameAsync` функции.
`ioDirID`	Каталог ID родительского каталога указанного файла или каталога.
`spec`	Цель или источник `FSRef`.
`parentRef`	Вторичное устройство или целевой `FSRef`. (Или касательно каталога для перемещения другого файла или каталога в).
`newRef`	Вывод `FSRef` (т.е., новое `FSRef` ).
`textEncodingHint`	Текст, кодирующий подсказку для имени Unicode файла или каталога, используемого `PBMakeFSRefSync`, `PBMakeFSRefAsync`, `PBRenameSync`, и `PBRenameAsync` функции.
`outName`	На выводе, указателе на имя Unicode файла или каталога, используемого `PBGetCatalogInfoSync` и `PBGetCatalogInfoAsync` функции.

Доступность

Доступный в OS X v10.0 и позже.


      
      FSSearchParams

Описывает критерии поиска для информационного поиска каталога.

Объявление

Swift

struct FSSearchParams { var searchTime: Duration var searchBits: OptionBits var searchNameLength: UniCharCount var searchName: UnsafePointer<UniChar> var searchInfo1: UnsafeMutablePointer<FSCatalogInfo> var searchInfo2: UnsafeMutablePointer<FSCatalogInfo> }

Objective C

struct FSSearchParams { Duration searchTime; OptionBits searchBits; UniCharCount searchNameLength; const UniChar * searchName; FSCatalogInfo * searchInfo1; FSCatalogInfo * searchInfo2; }; typedef struct FSSearchParams FSSearchParams; typedef FSSearchParams * FSSearchParamsPtr;

Поля

`searchTime`	Продолжительность Тайм менеджера на время поиска. При указании ненулевого значения в этом поле поиск может завершиться после требуемого времени, даже если максимальное количество нужных объектов не было возвращено и не был отсканирован весь каталог. Если это значение отрицательно, время интерпретируется в микросекундах; если положительный, это интерпретируется как миллисекунды. Если `searchTime` нуль, на поиске нет никакого ограничения по времени.
`searchBits`	Ряд битов, указывающих, который поля информации о каталоге искать на. Посмотрите Константы Поиска Каталога для констант, которые можно использовать здесь.
`searchNameLength`	Длина Unicode называет для поиска.
`searchName`	Указатель на Unicode называет для поиска.
`searchInfo1`	`FSCatalogInfo` структура, указывающая значения и нижние границы поиска.
`searchInfo2`	A `FSCatalogInfo` структура, указывающая маски и верхние границы поиска.

Обсуждение

Используемый FSCatalogSearch , PBCatalogSearchSync , и PBCatalogSearchAsync указать критерии поиска каталога.

Доступность

Доступный в OS X v10.0 и позже.


      
      FSSpec

Указывает название и местоположение файла или каталога.

Объявление

Swift

struct FSSpec { var hidden: (UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8) }

Objective C

struct FSSpec { short vRefNum; long parID; StrFileName name; }; typedef struct FSSpec FSSpec; typedef FSSpec * FSSpecPtr;

Поля

`vRefNum`	Ссылочный номер объема объема, содержащего указанный файл или каталог.
`parID`	Родительский каталог ID указанного файла или каталога (каталог ID каталога, содержащего данный файл или каталог).
`name`	Имя указанного файла или каталога. В Углероде это имя должно быть листовым именем; имя не может содержать точку с запятой.

Обсуждение

FSSpec структура может описать только файл или каталог, не объем. Объем может быть идентифицирован его корневым каталогом, несмотря на то, что системное программное обеспечение никогда не использует FSSpec структура для описания объема. Каталог ID родительского каталога корня fsRtParID. Имя корневого каталога совпадает с именем объема.

Если необходимо преобразовать спецификацию файла в FSSpec структура, вызовите функцию FSMakeFSSpec . Не заполняйте поля FSSpec структура самостоятельно.

Доступность

Доступный в OS X v10.0 и позже.

FSSpecArrayPtr FSSpecArrayPtr

Определяет указатель на массив FSSpec структуры.

Объявление

Swift

typealias FSSpecArrayPtr = FSSpecPtr

Objective C

typedef FSSpecPtr FSSpecArrayPtr;

Обсуждение

Посмотрите FSSpec.

Оператор импорта

Objective C

@import CoreServices;

Swift

import CoreServices

Доступность

Доступный в OS X v10.0 и позже.
FSUnmountStatus FSUnmountStatus

Объявление

Swift

typealias FSUnmountStatus = UInt32

Objective C

typedef UInt32 FSUnmountStatus;

Оператор импорта

Objective C

@import CoreServices;

Swift

import CoreServices

Доступность

Доступный в OS X v10.2 и позже.
FSVolumeEjectUPP FSVolumeEjectUPP

Объявление

Swift

typealias FSVolumeEjectUPP = FSVolumeEjectProcPtr

Objective C

typedef FSVolumeEjectProcPtr FSVolumeEjectUPP;

Обсуждение

Для получения дополнительной информации см. описание FSVolumeEjectProcPtr функция обратного вызова.

Оператор импорта

Objective C

@import CoreServices;

Swift

import CoreServices

Доступность

Доступный в OS X v10.2 и позже.


      
      FSVolumeInfo

Используемый при получении или установке информации об объеме.

Объявление

Swift

struct FSVolumeInfo { var createDate: UTCDateTime var modifyDate: UTCDateTime var backupDate: UTCDateTime var checkedDate: UTCDateTime var fileCount: UInt32 var folderCount: UInt32 var totalBytes: UInt64 var freeBytes: UInt64 var blockSize: UInt32 var totalBlocks: UInt32 var freeBlocks: UInt32 var nextAllocation: UInt32 var rsrcClumpSize: UInt32 var dataClumpSize: UInt32 var nextCatalogID: UInt32 var finderInfo: (UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8) var flags: UInt16 var filesystemID: UInt16 var signature: UInt16 var driveNumber: UInt16 var driverRefNum: FSIORefNum }

Objective C

struct FSVolumeInfo { UTCDateTime createDate; UTCDateTime modifyDate; UTCDateTime backupDate; UTCDateTime checkedDate; UInt32 fileCount; UInt32 folderCount; UInt64 totalBytes; UInt64 freeBytes; UInt32 blockSize; UInt32 totalBlocks; UInt32 freeBlocks; UInt32 nextAllocation; UInt32 rsrcClumpSize; UInt32 dataClumpSize; UInt32 nextCatalogID; UInt8 finderInfo[32]; UInt16 flags; UInt16 filesystemID; UInt16 signature; UInt16 driveNumber; short driverRefNum; }; typedef struct FSVolumeInfo FSVolumeInfo; typedef FSVolumeInfo * FSVolumeInfoPtr;

Поля

`createDate`	Дата и время объем создавалась. Значение 0 средних значений, что дата создания объема неизвестна.
`modifyDate`	В прошлый раз, когда объем был изменен всегда. Значение 0 «никогда» означает или “неизвестный.
`backupDate`	Когда объем был в последний раз скопирован, указывает. Это поле для использования утилитами резервного копирования. Значение 0 «никогда» означает или “неизвестный.
`checkedDate`	Последняя дата и время, что объем был проверен на непротиворечивость. Значение 0 «никогда» означает или “неизвестный.
`fileCount`	Общее количество файлов на объеме, или 0, если неизвестный.
`folderCount`	Общее количество папок на объеме, или 0, если неизвестный. Обратите внимание на то, что никакие количества корневого каталога.
`totalBytes`	Размер объема в байтах.
`freeBytes`	Число байтов свободного пространства на объеме.
`blockSize`	Размер блока выделения, в байтах. Это поле является только подходящим для форматов объема (таких как HFS и HFS Плюс), которые выделяют площадь в частях фиксированного размера; другие форматы объема могут не иметь подобного понятия и могут обнулить это поле.
`totalBlocks`	Общее количество выделения блокирует на объеме. Это поле является только подходящим для форматов объема (таких как HFS и HFS Плюс), которые выделяют площадь в частях фиксированного размера; другие форматы объема могут не иметь подобного понятия и могут обнулить это поле.
`freeBlocks`	Число неиспользованного выделения блокирует на объеме. Это поле является только подходящим для форматов объема (таких как HFS и HFS Плюс), которые выделяют площадь в частях фиксированного размера; другие форматы объема могут не иметь подобного понятия и могут обнулить это поле.
`nextAllocation`	Подсказка для того, где начать искать свободное пространство во время выделения. Это поле является только подходящим для форматов объема (таких как HFS и HFS Плюс), которые выделяют площадь в частях фиксированного размера; другие форматы объема могут не иметь подобного понятия и могут обнулить это поле.
`rsrcClumpSize`	Размер глыбы ветви ресурсов по умолчанию. Когда ветвление автоматически увеличено, как оно записано, Файловый менеджер пытается выделить площадь, которая является кратным числом размера глыбы. Это поле является нулем для форматов объема, не поддерживающих понятие размера глыбы.
`dataClumpSize`	Размер глыбы ветви данных по умолчанию. Когда ветвление автоматически увеличено, как оно записано, Файловый менеджер пытается выделить площадь, которая является кратным числом размера глыбы. Это поле является нулем для форматов объема, не поддерживающих понятие размера глыбы.
`nextCatalogID`	Следующий неиспользованный узел каталога ID. Некоторые форматы объема (такие как HFS и HFS Плюс) используют монотонно растущее число для узла каталога ID (т.е. Идентификатор файла или Каталог ID) недавно создаваемых файлов и каталогов. Для тех форматов объема, `nextCatalogID` следующий файл/каталог ID, который будет присвоен. Для других форматов объема это поле будет нулем.
`finderInfo`	Информация, используемая Средством поиска, таким как Каталог ID Системной папки. Некоторые форматы объема не поддерживают информацию о Средстве поиска для объема и установят это поле во все, обнуляет.
`flags`	Это поле содержит битовые флаги, содержащие информацию об объеме. Посмотрите Флаги информации об Объеме для констант атрибута, которые можно использовать здесь.
`filesystemID`	Идентифицирует реализацию файловой системы, обрабатывающую объем; это - нуль для HFS и HFS Плюс объемы.
`signature`	Это поле используется для различения форматы объема, поддерживаемые единственной реализацией файловой системы.
`driveNumber`	Число диска для диска (управляют элементом очереди), связанный с объемом. OS X не поддерживает числа диска; в OS X Файловый менеджер всегда возвращает значение 1 в этом поле.
`driverRefNum`	Ссылочный номер драйвера для диска (управляют элементом очереди), связанный с объемом.

Обсуждение

Эта структура содержит информацию об объеме в целом, информация о корневом каталоге объема использовала бы FSCatalogInfo структура.

Доступность

Доступный в OS X v10.0 и позже.

FSVolumeInfoBitmap FSVolumeInfoBitmap

Описывает который поля FSVolumeInfo структура Вы хотите получить или установить.

Объявление

Swift

typealias FSVolumeInfoBitmap = UInt32

Objective C

typedef UInt32 FSVolumeInfoBitmap;

Обсуждение

Если бит, соответствующий определенному полю, не установлен в битовом массиве, то то поле не изменяется в FSVolumeInfo структура, если это - выходной параметр и то поле, проигнорирована если FSVolumeInfo структура является входным параметром. Посмотрите Растровые Константы информации об Объеме для описания констант, которые необходимо использовать с этим типом данных.

Оператор импорта

Objective C

@import CoreServices;

Swift

import CoreServices

Доступность

Доступный в OS X v10.0 и позже.


      
      FSVolumeInfoParam

Определяет блок параметра, используемый низкоуровневым HFS Плюс функции манипулирования объемом.

Объявление

Swift

struct FSVolumeInfoParam { var qLink: QElemPtr var qType: Int16 var ioTrap: Int16 var ioCmdAddr: Ptr var ioCompletion: IOCompletionUPP var ioResult: OSErr var ioNamePtr: StringPtr var ioVRefNum: FSVolumeRefNum var volumeIndex: UInt32 var whichInfo: FSVolumeInfoBitmap var volumeInfo: UnsafeMutablePointer<FSVolumeInfo> var volumeName: UnsafeMutablePointer<HFSUniStr255> var ref: UnsafeMutablePointer<FSRef> }

Objective C

struct FSVolumeInfoParam { QElemPtr qLink; short qType; short ioTrap; Ptr ioCmdAddr; IOCompletionUPP ioCompletion; volatile OSErr ioResult; StringPtr ioNamePtr; FSVolumeRefNum ioVRefNum; UInt32 volumeIndex; FSVolumeInfoBitmap whichInfo; FSVolumeInfo * volumeInfo; HFSUniStr255 * volumeName; FSRef * ref; }; typedef struct FSVolumeInfoParam FSVolumeInfoParam; typedef FSVolumeInfoParam * FSVolumeInfoParamPtr;

Поля

`qLink`	Указатель на следующую запись в очереди файлового ввода-вывода. (Это поле используется внутренне Файловым менеджером для отслеживания асинхронные вызовы, ждущие выполнения.
`qType`	Тип очереди. Это поле используется внутренне Файловым менеджером.
`ioTrap`	Число прерывания вызванной функции. Это поле используется внутренне Файловым менеджером.
`ioCmdAddr`	Адрес вызванной функции. Это поле используется внутренне Файловым менеджером.
`ioCompletion`	Универсальный указатель процедуры на подпрограмму завершения, которая будет выполняться в конце асинхронного вызова. Это должно быть 0 для асинхронных вызовов без подпрограммы завершения и автоматически установлено в 0 для всех синхронных вызовов. Посмотрите `IOCompletionProcPtr` для получения информации о подпрограммах завершения.
`ioResult`	Код результата функции. Для синхронных вызовов это поле совпадает с кодом результата самого вызова функции. Для определения, когда асинхронный вызов был фактически завершен приложение может опросить это поле, это установлено в положительное число, когда вызов выполняется и получает фактический код результата, когда завершается вызов.
`ioNamePtr`	Указатель на имя тома. Это поле не использовано.
`ioVRefNum`	Ссылочный номер объема.
`volumeIndex`	Индекс объема. Если это поле 0, значение в `ioVRefNum` поле только используется для идентификации целевого объема.
`whichInfo`	Битовый массив, указывающий, который поля информации об объеме получить или начаться `FSVolumeInfo` структура передала в `volumeInfo` поле. Посмотрите Растровые Константы информации об Объеме для значения битов в этом поле.
`volumeInfo`	Указатель на информационную структуру объема, содержащую запрошенную информацию объема по возврату или новые значения информации об объеме для установки на вводе. Посмотрите `FSVolumeInfo`.
`volumeName`	На выводе, указателе на имя объема.
`ref`	Указатель на `FSRef` для корневого каталога указанного объема.

Доступность

Доступный в OS X v10.0 и позже.

FSVolumeMountUPP FSVolumeMountUPP

Объявление

Swift

typealias FSVolumeMountUPP = FSVolumeMountProcPtr

Objective C

typedef FSVolumeMountProcPtr FSVolumeMountUPP;

Обсуждение

Для получения дополнительной информации см. описание FSVolumeMountProcPtr функция обратного вызова.

Оператор импорта

Objective C

@import CoreServices;

Swift

import CoreServices

Доступность

Доступный в OS X v10.2 и позже.
FSVolumeOperation FSVolumeOperation

Объявление

Swift

typealias FSVolumeOperation = COpaquePointer

Objective C

typedef struct OpaqueFSVolumeOperation * FSVolumeOperation;

Оператор импорта

Objective C

@import CoreServices;

Swift

import CoreServices

Доступность

Доступный в OS X v10.2 и позже.
FSVolumeRefNum FSVolumeRefNum

Идентифицирует определенный смонтированный объем.

Объявление

Swift

typealias FSVolumeRefNum = Int16

Objective C

typedef SInt16 FSVolumeRefNum;

Обсуждение

Этот тип данных совпадает с 16-разрядным объемом refnum, ранее передал в ioVRefNum поля блока параметра; это - просто новое имя типа для старого типа данных.

Оператор импорта

Objective C

@import CoreServices;

Swift

import CoreServices

Доступность

Доступный в OS X v10.0 и позже.
FSVolumeUnmountUPP FSVolumeUnmountUPP

Объявление

Swift

typealias FSVolumeUnmountUPP = FSVolumeUnmountProcPtr

Objective C

typedef FSVolumeUnmountProcPtr FSVolumeUnmountUPP;

Обсуждение

Для получения дополнительной информации см. описание FSVolumeUnmountProcPtr функция обратного вызова.

Оператор импорта

Objective C

@import CoreServices;

Swift

import CoreServices

Доступность

Доступный в OS X v10.2 и позже.


      
      GetVolParmsInfoBuffer

Определяет буфер атрибутов объема, используемый PBHGetVolParmsSync и PBHGetVolParmAsync функции для возврата информации об объеме.

Объявление

Swift

struct GetVolParmsInfoBuffer { var vMVersion: Int16 var vMAttrib: Int32 var vMLocalHand: Handle var vMServerAdr: Int32 var vMVolumeGrade: Int32 var vMForeignPrivID: Int16 var vMExtendedAttributes: Int32 var vMDeviceID: UnsafeMutablePointer<Void> var vMMaxNameLength: UniCharCount }

Objective C

struct GetVolParmsInfoBuffer { short vMVersion; long vMAttrib; Handle vMLocalHand; long vMServerAdr; long vMVolumeGrade; short vMForeignPrivID; long vMExtendedAttributes; void * vMDeviceID; UniCharCount vMMaxNameLength; }; typedef struct GetVolParmsInfoBuffer GetVolParmsInfoBuffer;

Поля

`vMVersion`	Номер версии атрибутов буферизует структуру. В настоящее время это поле возвращается 1, 2, 3 или 4. Версия 3 представлена для поддержки HFS Плюс APIs.
`vMAttrib`	32-разрядное количество, кодирующее информацию об атрибутах объема. Посмотрите Константы Атрибута Объема для значения битов в этом поле.
`vMLocalHand`	Дескриптор к частным данным для совместно используемых томов. На создании VCB (прямо после монтирования), это поле является дескриптором к 2-байтовому блоку памяти. Средство поиска использует это для своего локального хранения списка окна, выделяя и освобождая память по мере необходимости. Когда объем размонтирован, от этого избавляются. Ваше приложение должно обработать это поле, как зарезервировано.
`vMServerAdr`	Для объемов сервера AppleTalk это поле содержит интернет-адрес объема сервера AppleTalk. Ваше приложение может проверить это поле для сообщения, какие объемы принадлежат который сервер; если объем не имеет сервера, значение этого поля 0.
`vMVolumeGrade`	Оценка относительной скорости объема. Масштаб, используемый для определения этих значений, в настоящее время не калибруется. В целом нижние значения указывают более быстрые скорости. Значение 0 указывает, что скорость объема является нерасчетной. Буферная версия возвратилась в `vMVersion` поле должно быть больше, чем 1 для этого поля быть значимым.
`vMForeignPrivID`	Целое число, представляющее модель полномочия, поддерживается объемом. В настоящее время два значения определяются для этого поля: 0 представляет стандартный HFS или HFS Плюс объем, который мог бы или не мог бы поддерживать модель полномочия AFP; `fsUnixPriv` представляет объем, поддерживающий модель полномочия A/UX. Буферная версия возвратилась в `vMVersion` поле должно быть больше, чем 1 для этого поля быть значимым.
`vMExtendedAttributes`	Содержит биты, описывающие расширенные атрибуты объема. Для этого поля, чтобы быть значимым, `vMVersion` должно быть больше, чем 2. Посмотрите Расширенные Атрибуты Объема для значения битов в этом поле.
`vMDeviceID`	Имя устройства, идентифицирующее устройство в/dev, соответствующем объему. Можно использовать эту строку для создания пути POSIX к устройству для использования с APIs IOKit.
`vMMaxNameLength`

Обсуждение

Объемы, реализующие HFS Плюс APIs, должны использовать версию 3 (или более новый) GetVolParmsInfoBuffer. Объемы, не реализующие HFS Плюс APIs, могут все еще реализовать версию 3 GetVolParmsInfoBuffer. Если версия GetVolParmsInfoBuffer 2 или меньше, или bSupportsHFSPlusAPIs бит ясен (нуль), тогда объем не реализует HFS Плюс APIs, и они эмулируются для того объема самим Файловым менеджером.

Если объем не реализует HFS Плюс APIs и поддерживает версию 2 или ранее GetVolParmsInfoBuffer, это не может самостоятельно описать, поддерживает ли это FSCatalogSearch или FSExchangeObjects вызовы. Уровень совместимости реализует FSCatalogSearch вызовите, если объем поддерживает PBCatSearch вызовите (т.е. bHasCatSearch бит vMAttrib установлен). Уровень совместимости реализует FSExchangeObjects вызовите, если объем поддерживает PBExchangeFiles (т.е. bHasFileIDs бит vMAttrib установлен).

Доступность

Доступный в OS X v10.0 и позже.


      
      HFileInfo

Определяет структуру, содержащую информацию о каталоге о файле.

Объявление

Objective C

struct HFileInfo { QElemPtr qLink; short qType; short ioTrap; Ptr ioCmdAddr; IOCompletionUPP ioCompletion; volatile OSErr ioResult; StringPtr ioNamePtr; short ioVRefNum; short ioFRefNum; SInt8 ioFVersNum; SInt8 filler1; short ioFDirIndex; SInt8 ioFlAttrib; SInt8 ioACUser; FInfo ioFlFndrInfo; long ioDirID; unsigned short ioFlStBlk; long ioFlLgLen; long ioFlPyLen; unsigned short ioFlRStBlk; long ioFlRLgLen; long ioFlRPyLen; unsigned long ioFlCrDat; unsigned long ioFlMdDat; unsigned long ioFlBkDat; FXInfo ioFlXFndrInfo; long ioFlParID; long ioFlClpSiz; }; typedef struct HFileInfo HFileInfo;

Поля

`qLink`	Указатель на следующую запись в очереди файлового ввода-вывода. (Это поле используется внутренне Файловым менеджером для отслеживания асинхронные вызовы, ждущие выполнения.
`qType`	Тип очереди. Это поле используется внутренне Файловым менеджером.
`ioTrap`	Число прерывания вызванной функции. Это поле используется внутренне Файловым менеджером.
`ioCmdAddr`	Адрес вызванной функции. Это поле используется внутренне Файловым менеджером.
`ioCompletion`	Универсальный указатель процедуры на подпрограмму завершения, которая будет выполняться в конце асинхронного вызова. Это должно быть 0 для асинхронных вызовов без подпрограммы завершения и автоматически установлено в 0 для всех синхронных вызовов. Посмотрите `IOCompletionProcPtr` для получения информации о подпрограммах завершения.
`ioResult`	Код результата функции. Для синхронных вызовов это поле совпадает с кодом результата самого вызова функции. Для определения, когда асинхронный вызов был фактически завершен приложение может опросить это поле, это установлено в положительное число, когда вызов выполняется и получает фактический код результата, когда завершается вызов.
`ioNamePtr`	Указатель на путь. Каждый раз, когда функциональное описание указывает это `ioNamePtr` используется — очень важно ли для ввода, вывода или обоих — чтобы Вы установили это поле для указания на хранение для a `Str255` значение (если Вы используете путь), или к `NULL` (если Вы не).
`ioVRefNum`	Ссылочный номер объема, 0 для объема по умолчанию или числа диска.
`ioFRefNum`	Число ссылки на файл открытого файла.
`ioFVersNum`	Номер версии файла. Это поле больше не используется. Номера версии файла являются артефактом устаревшего MFS и не поддерживаются на объемах HFS. Необходимо всегда устанавливать это поле в 0.
`filler1`	Зарезервированный.
`ioFDirIndex`	Файл и индекс каталога. Если это поле содержит положительное число, `PBGetCatInfoSync` и `PBGetCatInfoAsync` возвратите информацию о файле или каталоге, имеющем тот индекс каталога в каталоге, указанном `ioVRefNum` поле. (Если `ioVRefNum` содержит ссылочный номер объема, указанный каталог то, что корневой каталог объема.) Если это поле содержит 0, `PBGetCatInfoSync` или `PBGetCatInfoAsync` информация о возвратах о файле или каталоге, имя которого указано в `ioNamePtr` поле и это расположены в каталоге, указанном `ioVRefNum` поле. (Еще раз, если `ioVRefNum` содержит ссылочный номер объема, указанный каталог то, что корневой каталог объема.) Если это поле содержит отрицательное число, `PBGetCatInfoSync` или `PBGetCatInfoAsync` игнорирует `ioNamePtr` поле и информация о возвратах о каталоге, указанном в `ioDirID` поле. Если оба `ioDirID` и `ioVRefNum` установлены в 0, `PBGetCatInfoSync` или `PBGetCatInfoAsync` информация о возвратах о текущем каталоге по умолчанию.
`ioFlAttrib`	Атрибуты файла или каталога. Посмотрите Константы Атрибута файла для значения битов в этом поле.
`ioACUser`	Права доступа пользователя для указанного каталога. Посмотрите Константы Полномочий пользователя для значения битов в этом поле.
`ioFlFndrInfo`	Информация о средстве поиска.
`ioDirID`	Каталог ID или идентификатор файла. На вводе к `PBGetCatInfoSync` или `PBGetCatInfoAsync` , это поле содержит каталог ID (который используется только если `ioFDirIndex` поле отрицательно). На выводе это поле содержит идентификатор файла указанного файла.
`ioFlStBlk`	Первый блок выделения ветви данных. Если ветвь данных файла пуста, это поле содержит 0.
`ioFlLgLen`	Логическая длина (логический конец файла) ветви данных.
`ioFlPyLen`	Физическая длина (физический конец файла) ветви данных.
`ioFlRStBlk`	Первый блок выделения ветви ресурсов.
`ioFlRLgLen`	Логическая длина (логический конец файла) ветви ресурсов.
`ioFlRPyLen`	Физическая длина (физический конец файла) ветви ресурсов.
`ioFlCrDat`	Дата и время создания файла, в секундах с полуночи, 1 января 1904. Однако на OS X при установке даты создания в дату между 1 января 1904 и 1 января 1970 она будет отсечена до 1 января 1970, и это - значение, которое будет возвращено, если Вы позже попытаетесь получить дату создания. Обратите внимание на то, что файловые системы кроме AFP, HFS и HFS Плюс обычно не поддерживают даты создания.
`ioFlMdDat`	Дата и время последнего изменения к файлу, в секундах с полуночи, 1 января 1904. Однако на OS X, если Вы назначаете дату модификации к дате между 1 января 1904 и 1 января 1970, она будет отсечена до 1 января 1970.
`ioFlBkDat`	Дата и время, что файл был в последний раз скопирован, в секундах с полуночи, 1 января 1904. Однако на OS X, если Вы назначаете резервную дату к дате между 1 января 1904 и 1 января 1970, она будет отсечена до 1 января 1970. Обратите внимание на то, что файловые системы кроме AFP, HFS и HFS Плюс обычно не поддерживают резервные даты.
`ioFlXFndrInfo`	Дополнительная информация о Средстве поиска.
`ioFlParID`	Каталог ID родительского каталога файла.
`ioFlClpSiz`	Размер глыбы, который будет использоваться при записи файла, если это 0, размер глыбы объема, используется, когда открыт файл.

Доступность

Доступный в OS X v10.0 и позже.

Не доступный 64-разрядным приложениям.


      
      HFileParam

Определяет блок параметра, используемый низкоуровневыми функциями HFS для создания файла, удаления и информационного поиска.

Объявление

Objective C

struct HFileParam { QElemPtr qLink; short qType; short ioTrap; Ptr ioCmdAddr; IOCompletionUPP ioCompletion; volatile OSErr ioResult; StringPtr ioNamePtr; short ioVRefNum; short ioFRefNum; SInt8 ioFVersNum; SInt8 filler1; short ioFDirIndex; SInt8 ioFlAttrib; SInt8 ioFlVersNum; FInfo ioFlFndrInfo; long ioDirID; unsigned short ioFlStBlk; long ioFlLgLen; long ioFlPyLen; unsigned short ioFlRStBlk; long ioFlRLgLen; long ioFlRPyLen; unsigned long ioFlCrDat; unsigned long ioFlMdDat; }; typedef struct HFileParam HFileParam; typedef HFileParam * HFileParamPtr;

Поля

`qLink`	Указатель на следующую запись в очереди файлового ввода-вывода. (Это поле используется внутренне Файловым менеджером для отслеживания асинхронные вызовы, ждущие выполнения.
`qType`	Тип очереди. Это поле используется внутренне Файловым менеджером.
`ioTrap`	Число прерывания вызванной функции. Это поле используется внутренне Файловым менеджером.
`ioCmdAddr`	Адрес вызванной функции. Это поле используется внутренне Файловым менеджером.
`ioCompletion`	Универсальный указатель процедуры на подпрограмму завершения, которая будет выполняться в конце асинхронного вызова. Это должно быть 0 для асинхронных вызовов без подпрограммы завершения и автоматически установлено в 0 для всех синхронных вызовов. Посмотрите `IOCompletionProcPtr` для получения информации о подпрограммах завершения.
`ioResult`	Код результата функции. Для синхронных вызовов это поле совпадает с кодом результата самого вызова функции. Для определения, когда асинхронный вызов был фактически завершен приложение может опросить это поле, это установлено в положительное число, когда вызов выполняется и получает фактический код результата, когда завершается вызов.
`ioNamePtr`	Указатель на путь. Каждый раз, когда функциональное описание указывает это `ioNamePtr` используется — очень важно ли для ввода, вывода или обоих — чтобы Вы установили это поле для указания на хранение для a `Str255` значение (если Вы используете путь), или к `NULL` (если Вы не).
`ioVRefNum`	Ссылочный номер объема, 0 для объема по умолчанию или числа диска.
`ioFRefNum`	Число ссылки на файл открытого файла.
`ioFVersNum`	Номер версии файла. Это поле больше не используется. Номера версии файла являются артефактом устаревшего MFS и не поддерживаются на объемах HFS. Необходимо всегда устанавливать это поле в 0.
`filler1`	Зарезервированный.
`ioFDirIndex`	Индекс каталога для использования с `PBHGetFInfoSync` и `PBHGetFInfoAsync` функции.
`ioFlAttrib`	Атрибуты файла. Посмотрите Константы Атрибута файла для значения битов в этом поле.
`ioFlVersNum`	Номер версии файла. Эта функция больше не поддерживается, и необходимо всегда устанавливать это поле в 0.
`ioFlFndrInfo`	Информация используется Средством поиска.
`ioDirID`	Каталог ID.
`ioFlStBlk`	Первый блок выделения ветви данных. Если ветвь данных файла пуста, это поле содержит 0.
`ioFlLgLen`	Логическая длина (логический конец файла) ветви данных.
`ioFlPyLen`	Физическая длина (физический конец файла) ветви данных.
`ioFlRStBlk`	Первый блок выделения ветви ресурсов. Если ветвь ресурсов файла пуста, это поле содержит 0.
`ioFlRLgLen`	Логическая длина (логический конец файла) ветви ресурсов.
`ioFlRPyLen`	Физическая длина (физический конец файла) ветви ресурсов.
`ioFlCrDat`	Дата и время создания файла, указанного в секундах с полуночи, 1 января 1904.
`ioFlMdDat`	Дата и время последнего изменения к файлу, указанному в секундах с полуночи, 1 января 1904.

Доступность

Доступный в OS X v10.0 и позже.

Не доступный 64-разрядным приложениям.


      
      HFSUniStr255

Используемый Файловым менеджером для возврата строк Unicode.

Объявление

Objective C

struct HFSUniStr255 { UInt16 length; UniChar unicode[255]; }; typedef struct HFSUniStr255 HFSUniStr255;

Поля

`length`	Число unicode символов в строке.
`unicode`	Строка, в unicode символах.

Обсуждение

Этот тип данных является строкой до 255 16-разрядных символов Unicode с предыдущей 16-разрядной длиной (число символов). Обратите внимание на то, что только первые символы длины имеют значимые значения; оставшиеся символы могут быть установлены в произвольные значения. Вызывающая сторона должна всегда предполагать, что вся структура будет изменена, даже если фактическая длина строки будет меньше чем 255.

Доступность

Доступный в OS X v10.0 и позже.


      
      HIOParam

Определяет блок параметра, используемый низкоуровневым HFS функции I/O.

Объявление

Objective C

struct HIOParam { QElemPtr qLink; short qType; short ioTrap; Ptr ioCmdAddr; IOCompletionUPP ioCompletion; volatile OSErr ioResult; StringPtr ioNamePtr; short ioVRefNum; short ioRefNum; SInt8 ioVersNum; SInt8 ioPermssn; Ptr ioMisc; Ptr ioBuffer; long ioReqCount; long ioActCount; short ioPosMode; long ioPosOffset; }; typedef struct HIOParam HIOParam; typedef HIOParam * HIOParamPtr;

Поля

`qLink`	Указатель на следующую запись в очереди файлового ввода-вывода. (Это поле используется внутренне Файловым менеджером для отслеживания асинхронные вызовы, ждущие выполнения.
`qType`	Тип очереди. Это поле используется внутренне Файловым менеджером.
`ioTrap`	Число прерывания вызванной функции. Это поле используется внутренне Файловым менеджером.
`ioCmdAddr`	Адрес вызванной функции. Это поле используется внутренне Файловым менеджером.
`ioCompletion`	Универсальный указатель процедуры на подпрограмму завершения, которая будет выполняться в конце асинхронного вызова. Это должно быть 0 для асинхронных вызовов без подпрограммы завершения и автоматически установлено в 0 для всех синхронных вызовов. Посмотрите `IOCompletionProcPtr` для получения информации о подпрограммах завершения.
`ioResult`	Код результата функции. Для синхронных вызовов это поле совпадает с кодом результата самого вызова функции. Для определения, когда асинхронный вызов был фактически завершен приложение может опросить это поле, это установлено в положительное число, когда вызов выполняется и получает фактический код результата, когда завершается вызов.
`ioNamePtr`	Указатель на путь. Каждый раз, когда функциональное описание указывает это `ioNamePtr` используется — очень важно ли для ввода, вывода или обоих — чтобы Вы установили это поле для указания на хранение для a `Str255` значение (если Вы используете путь), или к `NULL` (если Вы не).
`ioVRefNum`	Ссылочный номер объема, 0 для объема по умолчанию или числа диска.
`ioRefNum`	Число ссылки на файл открытого файла.
`ioVersNum`	Номер версии. Это поле больше не используется, и необходимо всегда устанавливать его в 0.
`ioPermssn`	Режим доступа. Посмотрите Константы Разрешения Доступа к файлу.
`ioMisc`	В зависимости от вызванной функции это поле содержит или логический конец файла, новый номер версии, указатель на буфер пути доступа или указатель на новый путь. Поскольку `ioMisc` имеет тип `Ptr`, необходимо будет выполнить приведение типа для интерпретации значения `ioMisc` правильно, когда это содержит конец файла (a `LongInt` значение) или номер версии (a `SignedByte` значение).
`ioBuffer`	Указатель на буфер данных, в который данные записаны `PBReadSync` и `PBReadAsync` вызовы, и из которого данные считаны `PBWriteSync` и `PBWriteAsync` вызовы.
`ioReqCount`	Требуемое число байтов, которые будут считаны, записанный, или выделены.
`ioActCount`	Число байтов фактически читало, записанный, или выделенный.
`ioPosMode`	Режим расположения (базируют расположение) для установки метки. Биты 0 и 1 из этого поля указывают, как расположить метку; можно использовать константы, описанные в Константах Режима Позиции, чтобы установить или протестировать их значение. Можно также использовать константы, описанные в Константах Кэша, чтобы указать, кэшировать ли данные.
`ioPosOffset`	Смещение, которое будет использоваться в сочетании с основным расположением, указанным в `ioPosMode` поле.

Доступность

Доступный в OS X v10.0 и позже.

Не доступный 64-разрядным приложениям.


      
      HParamBlockRec

Описывает блок параметра HFS.

Объявление

Objective C

union HParamBlockRec { HIOParam ioParam; HFileParam fileParam; HVolumeParam volumeParam; AccessParam accessParam; ObjParam objParam; CopyParam copyParam; WDParam wdParam; FIDParam fidParam; CSParam csParam; ForeignPrivParam foreignPrivParam; }; typedef union HParamBlockRec HParamBlockRec; typedef HParamBlockRec * HParmBlkPtr;

Поля

`ioParam`	Блок параметра, используемый низкоуровневым HFS функции I/O. Посмотрите `HIOParam`.
`fileParam`	Блок параметра, используемый низкоуровневым HFS, функционирует для создания файла, удаления и информационного поиска. Посмотрите `HFileParam`.
`volumeParam`	Блок параметра, используемый низкоуровневыми функциями манипулирования объемом HFS. Посмотрите `HVolumeParam`.
`accessParam`	Блок параметра, используемый низкоуровневым файлом HFS и функциями манипулирования правами доступа каталога. Посмотрите `AccessParam`.
`objParam`	Блок параметра, используемый низкоуровневым пользователем HFS и функциями информации о группе. Посмотрите `ObjParam`.
`copyParam`	Блок параметра, используемый низкоуровневыми функциями копирования файла HFS. Посмотрите `CopyParam`.
`wdParam`	Блок параметра, используемый низкоуровневым HFS рабочие функции каталога. Посмотрите `WDParam`.
`fidParam`	Блок параметра, используемый низкоуровневыми функциями идентификатора файла HFS. Посмотрите `FIDParam`.
`csParam`	Блок параметра, используемый низкоуровневым каталогом HFS, ищет функции. Посмотрите `CSParam`.
`foreignPrivParam`	Блок параметра, используемый низкоуровневым HFS внешние функции полномочий. Посмотрите `ForeignPrivParam`.

Доступность

Доступный в OS X v10.0 и позже.

Не доступный 64-разрядным приложениям.


      
      HVolumeParam

Определяет блок параметра, используемый низкоуровневыми функциями манипулирования объемом HFS.

Объявление

Objective C

struct HVolumeParam { QElemPtr qLink; short qType; short ioTrap; Ptr ioCmdAddr; IOCompletionUPP ioCompletion; volatile OSErr ioResult; StringPtr ioNamePtr; short ioVRefNum; long filler2; short ioVolIndex; unsigned long ioVCrDate; unsigned long ioVLsMod; short ioVAtrb; unsigned short ioVNmFls; unsigned short ioVBitMap; unsigned short ioAllocPtr; unsigned short ioVNmAlBlks; unsigned long ioVAlBlkSiz; unsigned long ioVClpSiz; unsigned short ioAlBlSt; unsigned long ioVNxtCNID; unsigned short ioVFrBlk; unsigned short ioVSigWord; short ioVDrvInfo; short ioVDRefNum; short ioVFSID; unsigned long ioVBkUp; short ioVSeqNum; unsigned long ioVWrCnt; unsigned long ioVFilCnt; unsigned long ioVDirCnt; long ioVFndrInfo[8]; }; typedef struct HVolumeParam HVolumeParam; typedef HVolumeParam * HVolumeParamPtr;

Поля

`qLink`	Указатель на следующую запись в очереди файлового ввода-вывода. (Это поле используется внутренне Файловым менеджером для отслеживания асинхронные вызовы, ждущие выполнения.
`qType`	Тип очереди. Это поле используется внутренне Файловым менеджером.
`ioTrap`	Число прерывания вызванной функции. Это поле используется внутренне Файловым менеджером.
`ioCmdAddr`	Адрес вызванной функции. Это поле используется внутренне Файловым менеджером.
`ioCompletion`	Универсальный указатель процедуры на подпрограмму завершения, которая будет выполняться в конце асинхронного вызова. Это должно быть 0 для асинхронных вызовов без подпрограммы завершения и автоматически установлено в 0 для всех синхронных вызовов. Посмотрите `IOCompletionProcPtr` для получения информации о подпрограммах завершения.
`ioResult`	Код результата функции. Для синхронных вызовов это поле совпадает с кодом результата самого вызова функции. Для определения, когда асинхронный вызов был фактически завершен приложение может опросить это поле, это установлено в положительное число, когда вызов выполняется и получает фактический код результата, когда завершается вызов.
`ioNamePtr`	Указатель на путь. Каждый раз, когда функциональное описание указывает это `ioNamePtr` используется — очень важно ли для ввода, вывода или обоих — чтобы Вы установили это поле для указания на хранение для a `Str255` значение (если Вы используете путь), или к `NULL` (если Вы не).
`ioVRefNum`	Ссылочный номер объема, 0 для объема по умолчанию или числа диска.
`filler2`	Зарезервированный.
`ioVolIndex`	Индекс объема для использования с `PBHGetVInfoSync` и `PBHGetVInfoAsync` функции.
`ioVCrDate`	Дата и время инициализации объема.
`ioVLsMod`	Дата и время информация об объеме была в последний раз изменена. (Это поле не изменяется, когда информация записана в файл и не обязательно указывает, когда был сброшен объем.
`ioVAtrb`	Атрибуты объема. Посмотрите Константы Атрибута информации об Объеме для значений битов в этом поле.
`ioVNmFls`	Число файлов в корневом каталоге объема. По причинам производительности Файловый менеджер Углерода не возвращает число файлов в этом поле; вместо этого, это устанавливает `ioVNmFls` к 0. Для определения числа файлов в корневом каталоге объема в Углероде вызвать `PBGetCatInfoAsync` или `PBGetCatInfoSync` для корневого каталога. Число файлов в корневом каталоге возвращается в `ioDrNmFls` поле.
`ioVBitMap`	Первый блок битового массива объема.
`ioAllocPtr`	Блок, в котором запускается следующий новый файл. Используемый внутренне.
`ioVNmAlBlks`	Число блоков выделения.
`ioVAlBlkSiz`	Размер блоков выделения.
`ioVClpSiz`	Размер глыбы.
`ioAlBlSt`	Первый блок в карте объема.
`ioVNxtCNID`	Следующий неиспользованный узел каталога ID.
`ioVFrBlk`	Число неиспользованных блоков выделения.
`ioVSigWord`	Слово подписи, идентифицирующее тип объема, это - $D2D7 для объемов MFS и 4 244$ для объемов та поддержка вызовы HFS.
`ioVDrvInfo`	Число диска диска, содержащего объем.
`ioVDRefNum`	Для онлайновых объемов, ссылочного номера драйвера I/O для диска, идентифицированного `ioVDrvInfo` поле.
`ioVFSID`	Идентификатор файловой системы. Это указывает, какая файловая система обслуживает объем, это - нуль для объемов Файлового менеджера и ненулевой для объемов, обработанных внешней файловой системой.
`ioVBkUp`	Дата и время объем была в последний раз скопирована; если объем никогда не копировался, это 0.
`ioVSeqNum`	Используемый внутренне.
`ioVWrCnt`	Количество записи объема.
`ioVFilCnt`	Общее количество файлов на объеме.
`ioVDirCnt`	Общее количество каталогов (не включая корневой каталог) на объеме.
`ioVFndrInfo`	Информация используется Средством поиска.

Доступность

Доступный в OS X v10.0 и позже.

Не доступный 64-разрядным приложениям.

IOCompletionUPP IOCompletionUPP

Универсальный указатель процедуры на определенную с помощью приложения функцию завершения.

Объявление

Swift

typealias IOCompletionUPP = IOCompletionProcPtr

Objective C

typedef IOCompletionProcPtr IOCompletionUPP;

Обсуждение

Посмотрите IOCompletionProcPtr.

Оператор импорта

Objective C

@import CoreServices;

Swift

import CoreServices

Доступность

Доступный в OS X v10.0 и позже.


      
      IOParam

Определяет блок параметра, используемый низкоуровневыми функциями I/O.

Объявление

Objective C

struct IOParam { QElemPtr qLink; short qType; short ioTrap; Ptr ioCmdAddr; IOCompletionUPP ioCompletion; volatile OSErr ioResult; StringPtr ioNamePtr; short ioVRefNum; short ioRefNum; SInt8 ioVersNum; SInt8 ioPermssn; Ptr ioMisc; Ptr ioBuffer; long ioReqCount; long ioActCount; short ioPosMode; long ioPosOffset; }; typedef struct IOParam IOParam; typedef IOParam * IOParamPtr;

Поля

`qLink`	Указатель на следующую запись в очереди файлового ввода-вывода. (Это поле используется внутренне Файловым менеджером для отслеживания асинхронные вызовы, ждущие выполнения.
`qType`	Тип очереди. Это поле используется внутренне Файловым менеджером.
`ioTrap`	Число прерывания вызванной функции. Это поле используется внутренне Файловым менеджером.
`ioCmdAddr`	Адрес вызванной функции. Это поле используется внутренне Файловым менеджером.
`ioCompletion`	Универсальный указатель процедуры на подпрограмму завершения, которая будет выполняться в конце асинхронного вызова. Это должно быть 0 для асинхронных вызовов без подпрограммы завершения и автоматически установлено в 0 для всех синхронных вызовов. Посмотрите `IOCompletionProcPtr` для получения информации о подпрограммах завершения.
`ioResult`	Код результата функции. Для синхронных вызовов это поле совпадает с кодом результата самого вызова функции. Для определения, когда асинхронный вызов был фактически завершен приложение может опросить это поле, это установлено в положительное число, когда вызов выполняется и получает фактический код результата, когда завершается вызов.
`ioNamePtr`	Указатель на путь. Каждый раз, когда функциональное описание указывает это `ioNamePtr` используется — очень важно ли для ввода, вывода или обоих — чтобы Вы установили это поле для указания на хранение для a `Str255` значение (если Вы используете путь), или к `NULL` (если Вы не).
`ioVRefNum`	Ссылочный номер объема, 0 для объема по умолчанию или числа диска.
`ioRefNum`	Число ссылки на файл открытого файла.
`ioVersNum`	Номер версии. Это поле больше не используется, и необходимо всегда устанавливать его в 0.
`ioPermssn`	Режим доступа. Посмотрите Константы Разрешения Доступа к файлу.
`ioMisc`	В зависимости от вызванной функции это поле содержит любого новый логический конец файла (для `PBGetEOFSync/ PBGetEOFAsync` и `PBSetEOFSync/ PBSetEOFAsync` функции), новый номер версии или указатель на новый путь (для `PBHRenameSync`/ `PBHRenameAsync` функции). Поскольку `ioMisc` имеет тип `Ptr`, необходимо будет выполнить приведение типа для интерпретации значения `ioMisc` правильно, когда это содержит конец файла (a `LongInt` значение) или номер версии (a `SignedByte` значение).
`ioBuffer`	Указатель на буфер данных, в который данные записаны `PBReadSync` и `PBReadAsync` вызовы; и из которого данные считаны `PBWriteSync` и `PBWriteAsync` вызовы.
`ioReqCount`	Требуемое число байтов, которые будут считаны, записанный, или выделены.
`ioActCount`	Число байтов фактически читало, записанный, или выделенный.
`ioPosMode`	Режим расположения (базируют расположение) для расположения метки файла. Биты 0 и 1 из этого поля указывают, как расположить метку; можно использовать константы, описанные в Константах Режима Позиции, чтобы установить или протестировать их значение. Можно также использовать константы, описанные в Константах Кэша, чтобы указать, должны ли кэшироваться данные.
`ioPosOffset`	Смещение, которое будет использоваться в сочетании с основным расположением, указанным в `ioPosMode` поле.

Доступность

Доступный в OS X v10.0 и позже.

Не доступный 64-разрядным приложениям.


      
      MultiDevParam

Определяет блок параметра, используемый низкоуровневыми функциями в классическом Диспетчере устройств для доступа к многократным устройствам.

Объявление

Objective C

struct MultiDevParam { QElemPtr qLink; short qType; short ioTrap; Ptr ioCmdAddr; IOCompletionUPP ioCompletion; volatile OSErr ioResult; StringPtr ioNamePtr; short ioVRefNum; short ioMRefNum; SInt8 ioMVersNum; SInt8 ioMPermssn; Ptr ioMMix; short ioMFlags; Ptr ioSEBlkPtr; }; typedef struct MultiDevParam MultiDevParam; typedef MultiDevParam * MultiDevParamPtr;

Поля

`qLink`	Указатель на следующую запись в очереди файлового ввода-вывода. (Это поле используется внутренне Файловым менеджером для отслеживания асинхронные вызовы, ждущие выполнения.
`qType`	Тип очереди. Это поле используется внутренне Файловым менеджером.
`ioTrap`	Число прерывания вызванной функции. Это поле используется внутренне Файловым менеджером.
`ioCmdAddr`	Адрес вызванной функции. Это поле используется внутренне Файловым менеджером.
`ioCompletion`	Универсальный указатель процедуры на подпрограмму завершения, которая будет выполняться в конце асинхронного вызова. Это должно быть 0 для асинхронных вызовов без подпрограммы завершения и автоматически установлено в 0 для всех синхронных вызовов. Посмотрите `IOCompletionProcPtr` для получения информации о подпрограммах завершения.
`ioResult`	Код результата функции. Для синхронных вызовов это поле совпадает с кодом результата самого вызова функции. Для определения, когда асинхронный вызов был фактически завершен приложение может опросить это поле, это установлено в положительное число, когда вызов выполняется и получает фактический код результата, когда завершается вызов.
`ioNamePtr`	Указатель на путь. Каждый раз, когда функциональное описание указывает это `ioNamePtr` используется — очень важно ли для ввода, вывода или обоих — чтобы Вы установили это поле для указания на хранение для a `Str255` значение (если Вы используете путь), или к `NULL` (если Вы не).
`ioVRefNum`	Ссылочный номер объема, 0 для объема по умолчанию или числа диска.
`ioMRefNum`	Ссылочный номер драйвера.
`ioMVersNum`	Номер версии слота.
`ioMPermssn`	Полномочия.
`ioMMix`	Зарезервированный.
`ioMFlags`	Флаги, указывающие число дополнительных полей. Необходимо установить `fMulti` бит (укусил 0) этого поля и очищает все другие биты.
`ioSEBlkPtr`	Указатель на внешний блок параметра, настраивающийся для устройств, установленных в слоте.

Доступность

Доступный в OS X v10.0 и позже.

Не доступный 64-разрядным приложениям.


      
      ObjParam

Определяет блок параметра, используемый низкоуровневым пользователем HFS и функциями информации о группе.

Объявление

Objective C

struct ObjParam { QElemPtr qLink; short qType; short ioTrap; Ptr ioCmdAddr; IOCompletionUPP ioCompletion; volatile OSErr ioResult; StringPtr ioNamePtr; short ioVRefNum; short filler7; short ioObjType; StringPtr ioObjNamePtr; long ioObjID; }; typedef struct ObjParam ObjParam; typedef ObjParam * ObjParamPtr;

Поля

`qLink`	Указатель на следующую запись в очереди файлового ввода-вывода. (Это поле используется внутренне Файловым менеджером для отслеживания асинхронные вызовы, ждущие выполнения.
`qType`	Тип очереди. Это поле используется внутренне Файловым менеджером.
`ioTrap`	Число прерывания вызванной функции. Это поле используется внутренне Файловым менеджером.
`ioCmdAddr`	Адрес вызванной функции. Это поле используется внутренне Файловым менеджером.
`ioCompletion`	Универсальный указатель процедуры на подпрограмму завершения, которая будет выполняться в конце асинхронного вызова. Это должно быть 0 для асинхронных вызовов без подпрограммы завершения и автоматически установлено в 0 для всех синхронных вызовов. Посмотрите `IOCompletionProcPtr` для получения информации о подпрограммах завершения.
`ioResult`	Код результата функции. Для синхронных вызовов это поле совпадает с кодом результата самого вызова функции. Для определения, когда асинхронный вызов был фактически завершен приложение может опросить это поле, это установлено в положительное число, когда вызов выполняется и получает фактический код результата, когда завершается вызов.
`ioNamePtr`	Указатель на путь. Каждый раз, когда функциональное описание указывает это `ioNamePtr` используется — очень важно ли для ввода, вывода или обоих — чтобы Вы установили это поле для указания на хранение для a `Str255` значение (если Вы используете путь), или к `NULL` (если Вы не).
`ioVRefNum`	Ссылочный номер объема, 0 для объема по умолчанию или числа диска.
`filler7`	Зарезервированный.
`ioObjType`	Функциональный код. Значения, переданные в этом поле, определяются функцией, которой Вы передаете этот блок параметра.
`ioObjNamePtr`	Указатель на возвращенного создателя/название группы.
`ioObjID`	Создатель/группа ID.

Доступность

Доступный в OS X v10.0 и позже.

Не доступный 64-разрядным приложениям.


      
      ParamBlockRec

Описывает основной блок параметра Файлового менеджера.

Объявление

Objective C

union ParamBlockRec { IOParam ioParam; FileParam fileParam; VolumeParam volumeParam; CntrlParam cntrlParam; SlotDevParam slotDevParam; MultiDevParam multiDevParam; }; typedef union ParamBlockRec ParamBlockRec; typedef ParamBlockRec * ParmBlkPtr;

Поля

`ioParam`
`fileParam`
`volumeParam`
`cntrlParam`
`slotDevParam`
`multiDevParam`

Доступность

Доступный в OS X v10.0 и позже.


      
      SlotDevParam

Определяет блок параметра, используемый низкоуровневыми функциями в классическом Диспетчере устройств для доступа к единственному устройству слота.

Объявление

Objective C

struct SlotDevParam { QElemPtr qLink; short qType; short ioTrap; Ptr ioCmdAddr; IOCompletionUPP ioCompletion; volatile OSErr ioResult; StringPtr ioNamePtr; short ioVRefNum; short ioSRefNum; SInt8 ioSVersNum; SInt8 ioSPermssn; Ptr ioSMix; short ioSFlags; SInt8 ioSlot; SInt8 ioID; }; typedef struct SlotDevParam SlotDevParam; typedef SlotDevParam * SlotDevParamPtr;

Поля

`qLink`	Указатель на следующую запись в очереди файлового ввода-вывода. (Это поле используется внутренне Файловым менеджером для отслеживания асинхронные вызовы, ждущие выполнения.
`qType`	Тип очереди. Это поле используется внутренне Файловым менеджером.
`ioTrap`	Число прерывания вызванной функции. Это поле используется внутренне Файловым менеджером.
`ioCmdAddr`	Адрес вызванной функции. Это поле используется внутренне Файловым менеджером.
`ioCompletion`	Универсальный указатель процедуры на подпрограмму завершения, которая будет выполняться в конце асинхронного вызова. Это должно быть 0 для асинхронных вызовов без подпрограммы завершения и автоматически установлено в 0 для всех синхронных вызовов. Посмотрите `IOCompletionProcPtr` для получения информации о подпрограммах завершения.
`ioResult`	Код результата функции. Для синхронных вызовов это поле совпадает с кодом результата самого вызова функции. Для определения, когда асинхронный вызов был фактически завершен приложение может опросить это поле, это установлено в положительное число, когда вызов выполняется и получает фактический код результата, когда завершается вызов.
`ioNamePtr`	Указатель на путь. Каждый раз, когда функциональное описание указывает это `ioNamePtr` используется — очень важно ли для ввода, вывода или обоих — чтобы Вы установили это поле для указания на хранение для a `Str255` значение (если Вы используете путь), или к `NULL` (если Вы не).
`ioVRefNum`	Ссылочный номер объема, 0 для объема по умолчанию или числа диска.
`ioSRefNum`	Ссылочный номер драйвера.
`ioSVersNum`	Номер версии слота.
`ioSPermssn`	Полномочия.
`ioSMix`	Зарезервированный.
`ioSFlags`	Флаги, определяющие число дополнительных полей. Необходимо очистить все биты в этом поле.
`ioSlot`	Номер слота.
`ioID`	Ресурс слота ID.

Доступность

Доступный в OS X v10.0 и позже.

Не доступный 64-разрядным приложениям.

VCB

Определяет блок регулятора громкости.

Объявление

Objective C

struct VCB { QElemPtr qLink; short qType; short vcbFlags; unsigned short vcbSigWord; unsigned long vcbCrDate; unsigned long vcbLsMod; short vcbAtrb; unsigned short vcbNmFls; short vcbVBMSt; short vcbAllocPtr; unsigned short vcbNmAlBlks; long vcbAlBlkSiz; long vcbClpSiz; short vcbAlBlSt; long vcbNxtCNID; unsigned short vcbFreeBks; Str27 vcbVN; short vcbDrvNum; short vcbDRefNum; short vcbFSID; short vcbVRefNum; Ptr vcbMAdr; Ptr vcbBufAdr; short vcbMLen; short vcbDirIndex; short vcbDirBlk; unsigned long vcbVolBkUp; unsigned short vcbVSeqNum; long vcbWrCnt; long vcbXTClpSiz; long vcbCTClpSiz; unsigned short vcbNmRtDirs; long vcbFilCnt; long vcbDirCnt; long vcbFndrInfo[8]; unsigned short vcbVCSize; unsigned short vcbVBMCSiz; unsigned short vcbCtlCSiz; unsigned short vcbXTAlBlks; unsigned short vcbCTAlBlks; short vcbXTRef; short vcbCTRef; Ptr vcbCtlBuf; long vcbDirIDM; short vcbOffsM; }; typedef struct VCB VCB; typedef VCB * VCBPtr;

Поля

`qLink`	Указатель на следующую запись в очереди VCB.
`qType`	Тип очереди. Когда объем смонтирован, и VCB создается, это поле очищено. После того, бит, 7 из этого поля установлены каждый раз, когда открыт файл на том объеме.
`vcbFlags`	Флаги объема. Бит 15 установлен, если информация об объеме была изменена вызовом Файлового менеджера, так как объем был в последний раз сброшен a `FlushVol` вызвать. Посмотрите Блочные Флаги Регулятора громкости.
`vcbSigWord`	Подпись объема.
`vcbCrDate`	Дата и время создания объема (инициализация).
`vcbLsMod`	Дата и время последнего изменения объема. Когда объем был в последний раз сброшен, это не обязательно.
`vcbAtrb`	Атрибуты объема.
`vcbNmFls`	Число файлов в корневом каталоге объема.
`vcbVBMSt`	Первый блок битового массива объема.
`vcbAllocPtr`	Блок запуска следующего поиска выделения. Это поле используется внутренне.
`vcbNmAlBlks`	Число выделения блокирует в объеме.
`vcbAlBlkSiz`	Размер блока выделения, в байтах. Это значение должно всегда быть кратным числом 512 байтов.
`vcbClpSiz`	Размер глыбы по умолчанию.
`vcbAlBlSt`	Первое выделение блокирует в объеме.
`vcbNxtCNID`	Следующий неиспользованный узел каталога ID (каталог или идентификатор файла).
`vcbFreeBks`	Число неиспользованного выделения блокирует на объеме.
`vcbVN`	Имя тома. Обратите внимание на то, что имя тома может занять самое большее 27 символов; это - исключение к нормальному файлу и пределу имени каталога 31 символа.
`vcbDrvNum`	Число диска диска, на котором расположен объем. Когда подсоединенный внешний диск помещается оффлайн или извлекается, это поле установлено в 0.
`vcbDRefNum`	Ссылочный номер драйвера драйвера раньше получал доступ к объему, Когда объем извлекается, это поле установлено в предыдущее значение `vcbDrvNum` поле (и следовательно положительное число). Когда объем помещается оффлайн, это поле установлено в отрицание предыдущего значения `vcbDrvNum` поле (и следовательно отрицательное число).
`vcbFSID`	Идентификатор для файловой системы, обрабатывающей объем, это - нуль для объемов, обработанных Файловым менеджером и ненулевых для объемов, обработанных другими файловыми системами.
`vcbVRefNum`	Ссылочный номер объема объема.
`vcbMAdr`	Используемый внутренне.
`vcbBufAdr`	Используемый внутренне.
`vcbMLen`	Используемый внутренне.
`vcbDirIndex`	Используемый внутренне.
`vcbDirBlk`	Используемый внутренне.
`vcbVolBkUp`	Дата и время, что был в последний раз скопирован объем.
`vcbVSeqNum`	Используемый внутренне.
`vcbWrCnt`	Количество записи объема.
`vcbXTClpSiz`	Размер глыбы степеней переполняет файла.
`vcbCTClpSiz`	Размер глыбы файла каталога.
`vcbNmRtDirs`	Число каталогов в корневом каталоге.
`vcbFilCnt`	Общее количество файлов на объеме.
`vcbDirCnt`	Общее количество каталогов на объеме.
`vcbFndrInfo`	Информация о средстве поиска.
`vcbVCSize`	Используемый внутренне.
`vcbVBMCSiz`	Используемый внутренне.
`vcbCtlCSiz`	Используемый внутренне.
`vcbXTAlBlks`	Размер, в блоках выделения, степеней переполняет файла.
`vcbCTAlBlks`	Размер, в блоках выделения, файла каталога.
`vcbXTRef`	Ссылочный номер пути для степеней переполняет файла.
`vcbCTRef`	Ссылочный номер пути для файла каталога.
`vcbCtlBuf`	Указатель до степеней и кэшей каталога.
`vcbDirIDM`	Каталог в последний раз искал.
`vcbOffsM`	Потомки индексируют при последнем поиске.

Обсуждение

Блочная очередь регулятора громкости является стандартной очередью операционной системы, это сохраняется в системной «куче». Это содержит блок регулятора громкости для каждого смонтированного объема. Блок регулятора громкости является неперемещаемым блоком, содержащим специфичную для объема информацию.

Каждый раз, когда объем смонтирован, Файловый менеджер считывает свои информации объема из основного блока каталога и использует информацию для создания нового блока регулятора громкости (VCB) в блочной очереди регулятора громкости (если извлеченный или оффлайновый объем не повторно монтируется). Файловый менеджер также создает буфер объема в системной «куче». Когда объем помещается оффлайн, его буфер выпущен. Когда объем размонтирован, его VCB удален из очереди VCB также.

Доступность

Доступный в OS X v10.0 и позже.

Не доступный 64-разрядным приложениям.


      
      VolMountInfoHeader

Определяет объем, монтирующий информационную структуру заголовка для удаленных объемов.

Объявление

Swift

struct VolMountInfoHeader { var length: Int16 var media: VolumeType }

Objective C

struct VolMountInfoHeader { short length; VolumeType media; }; typedef struct VolMountInfoHeader VolMountInfoHeader; typedef VolMountInfoHeader * VolMountInfoPtr;

Поля


      length

Длина VolMountInfoHeader структура, которая является общей длиной заголовка структуры, описанного здесь плюс данные расположения переменной длины, следующие за заголовком.


      media

Тип объема удаленного объема. AppleShareMediaType представляет объем AppleShare.

Если Вы добавляете поддержку программируемых функций монтирования к файловой системе не-Macintosh, необходимо зарегистрировать идентификатор с четырьмя символами для объемов с DTS.

Обсуждение

Для монтирования удаленного сервера заполните VolMountInfoHeader структура с помощью PBGetVolMountInfo функционируйте и затем передайте эту структуру PBVolumeMount функционируйте для монтирования объема.

Доступность

Доступный в OS X v10.0 и позже.


      
      VolumeMountInfoHeader

Определяет расширенный объем, монтирующий информационную структуру заголовка для удаленных объемов.

Объявление

Swift

struct VolumeMountInfoHeader { var length: Int16 var media: VolumeType var flags: Int16 }

Objective C

struct VolumeMountInfoHeader { short length; VolumeType media; short flags; }; typedef struct VolumeMountInfoHeader VolumeMountInfoHeader; typedef VolumeMountInfoHeader * VolumeMountInfoHeaderPtr;

Поля

`length`	Длина `VolumeMountInfoHeader` структура, которая является общей длиной заголовка структуры, описанного здесь плюс данные расположения переменной длины, следующие за заголовком.
`media`	Тип объема удаленного объема. `AppleShareMediaType` представляет объем AppleShare. Если Вы добавляете поддержку программируемых функций монтирования к файловой системе не-Macintosh, необходимо зарегистрировать идентификатор с четырьмя символами для объемов с DTS.
`flags`	Объем монтирует флаги. Посмотрите, что Объем Монтирует Флаги.

Обсуждение

Этот объем монтирует, что информационная запись заменяет VolMountInfoHeader структура; VolMountInfoHeader включен для совместимости. VolumeMountInfoHeader запись предоставляет доступ к объему, монтируют флаги внешними писателями файловой системы.

Для монтирования удаленного сервера заполните VolumeMountInfoHeader структура с помощью PBGetVolMountInfo функционируйте и затем передайте эту структуру PBVolumeMount функционируйте для монтирования объема.

Доступность

Доступный в OS X v10.0 и позже.


      
      VolumeParam

Определяет блок параметра, используемый низкоуровневыми функциями манипулирования объемом.

Объявление

Objective C

struct VolumeParam { QElemPtr qLink; short qType; short ioTrap; Ptr ioCmdAddr; IOCompletionUPP ioCompletion; volatile OSErr ioResult; StringPtr ioNamePtr; short ioVRefNum; long filler2; short ioVolIndex; unsigned long ioVCrDate; unsigned long ioVLsBkUp; unsigned short ioVAtrb; unsigned short ioVNmFls; unsigned short ioVDirSt; short ioVBlLn; unsigned short ioVNmAlBlks; unsigned long ioVAlBlkSiz; unsigned long ioVClpSiz; unsigned short ioAlBlSt; unsigned long ioVNxtFNum; unsigned short ioVFrBlk; }; typedef struct VolumeParam VolumeParam; typedef VolumeParam * VolumeParamPtr;

Поля

`qLink`	Указатель на следующую запись в очереди файлового ввода-вывода. (Это поле используется внутренне Файловым менеджером для отслеживания асинхронные вызовы, ждущие выполнения.
`qType`	Тип очереди. Это поле используется внутренне Файловым менеджером.
`ioTrap`	Число прерывания вызванной функции. Это поле используется внутренне Файловым менеджером.
`ioCmdAddr`	Адрес вызванной функции. Это поле используется внутренне Файловым менеджером.
`ioCompletion`	Универсальный указатель процедуры на подпрограмму завершения, которая будет выполняться в конце асинхронного вызова. Это должно быть 0 для асинхронных вызовов без подпрограммы завершения и автоматически установлено в 0 для всех синхронных вызовов. Посмотрите `IOCompletionProcPtr` для получения информации о подпрограммах завершения.
`ioResult`	Код результата функции. Для синхронных вызовов это поле совпадает с кодом результата самого вызова функции. Для определения, когда асинхронный вызов был фактически завершен приложение может опросить это поле, это установлено в положительное число, когда вызов выполняется и получает фактический код результата, когда завершается вызов.
`ioNamePtr`	Указатель на путь. Каждый раз, когда функциональное описание указывает это `ioNamePtr` используется — очень важно ли для ввода, вывода или обоих — чтобы Вы установили это поле для указания на хранение для a `Str255` значение (если Вы используете путь), или к `NULL` (если Вы не).
`ioVRefNum`	Ссылочный номер объема, 0 для объема по умолчанию или числа диска.
`filler2`	Зарезервированный.
`ioVolIndex`	Индекс объема.
`ioVCrDate`	Дата и время инициализации объема.
`ioVLsBkUp`	Дата и время информация об объеме была в последний раз изменена. (Это поле не изменяется, когда информация записана в файл и не обязательно указывает, когда был сброшен объем.
`ioVAtrb`	Атрибуты объема. Посмотрите Константы Атрибута информации об Объеме для значений битов в этом поле.
`ioVNmFls`	Число файлов в корневом каталоге.
`ioVDirSt`	Первый блок каталога объема.
`ioVBlLn`	Длина каталога в блоках.
`ioVNmAlBlks`	Число блоков выделения.
`ioVAlBlkSiz`	Размер блоков выделения.
`ioVClpSiz`	Размер глыбы объема.
`ioAlBlSt`	Первый блок в карте объема.
`ioVNxtFNum`	Следующий неиспользованный номер документа.
`ioVFrBlk`	Число неиспользованных блоков выделения.

Доступность

Доступный в OS X v10.0 и позже.

Не доступный 64-разрядным приложениям.

VolumeType VolumeType

Определяет «подпись» файловой системы.

Объявление

Swift

typealias VolumeType = OSType

Objective C

typedef OSType VolumeType;

Оператор импорта

Objective C

@import CoreServices;

Swift

import CoreServices

Доступность

Доступный в OS X v10.0 и позже.


      
      WDParam

Определяет блок параметра, используемый низкоуровневым HFS рабочие функции каталога.

Объявление

Objective C

struct WDParam { QElemPtr qLink; short qType; short ioTrap; Ptr ioCmdAddr; IOCompletionUPP ioCompletion; volatile OSErr ioResult; StringPtr ioNamePtr; short ioVRefNum; short ioWDCreated; short ioWDIndex; long ioWDProcID; short ioWDVRefNum; short filler10; long filler11; long filler12; long filler13; long ioWDDirID; }; typedef struct WDParam WDParam; typedef WDParam * WDParamPtr;

Поля

`qLink`	Указатель на следующую запись в очереди файлового ввода-вывода. (Это поле используется внутренне Файловым менеджером для отслеживания асинхронные вызовы, ждущие выполнения.
`qType`	Тип очереди. Это поле используется внутренне Файловым менеджером.
`ioTrap`	Число прерывания вызванной функции. Это поле используется внутренне Файловым менеджером.
`ioCmdAddr`	Адрес вызванной функции. Это поле используется внутренне Файловым менеджером.
`ioCompletion`	Универсальный указатель процедуры на подпрограмму завершения, которая будет выполняться в конце асинхронного вызова. Это должно быть 0 для асинхронных вызовов без подпрограммы завершения и автоматически установлено в 0 для всех синхронных вызовов. Посмотрите `IOCompletionProcPtr` для получения информации о подпрограммах завершения.
`ioResult`	Код результата функции. Для синхронных вызовов это поле совпадает с кодом результата самого вызова функции. Для определения, когда асинхронный вызов был фактически завершен приложение может опросить это поле, это установлено в положительное число, когда вызов выполняется и получает фактический код результата, когда завершается вызов.
`ioNamePtr`	Указатель на путь. Каждый раз, когда функциональное описание указывает это `ioNamePtr` используется — очень важно ли для ввода, вывода или обоих — чтобы Вы установили это поле для указания на хранение для a `Str255` значение (если Вы используете путь), или к `NULL` (если Вы не).
`ioVRefNum`	Ссылочный номер объема, 0 для объема по умолчанию или числа диска.
`ioWDCreated`
`ioWDIndex`	Индекс к рабочим каталогам.
`ioWDProcID`
`ioWDVRefNum`	Ссылочный номер объема для рабочего каталога.
`filler10`	Зарезервированный.
`filler11`	Зарезервированный.
`filler12`	Зарезервированный.
`filler13`	Каталог ID рабочего каталога.
`ioWDDirID`	Каталог ID рабочего каталога.

Доступность

Доступный в OS X v10.0 и позже.

Не доступный 64-разрядным приложениям.


      
      WDPBRec

Определяет рабочий блок параметра каталога.

Объявление

Objective C

struct WDPBRec { QElemPtr qLink; short qType; short ioTrap; Ptr ioCmdAddr; IOCompletionUPP ioCompletion; volatile OSErr ioResult; StringPtr ioNamePtr; short ioVRefNum; short filler1; short ioWDIndex; long ioWDProcID; short ioWDVRefNum; short filler2[7]; long ioWDDirID; }; typedef struct WDPBRec WDPBRec; typedef WDPBRec * WDPBPtr;

Поля

`qLink`	Указатель на следующую запись в очереди файлового ввода-вывода. (Это поле используется внутренне Файловым менеджером для отслеживания асинхронные вызовы, ждущие выполнения.
`qType`	Тип очереди. Это поле используется внутренне Файловым менеджером.
`ioTrap`	Число прерывания вызванной функции. Это поле используется внутренне Файловым менеджером.
`ioCmdAddr`	Адрес вызванной функции. Это поле используется внутренне Файловым менеджером.
`ioCompletion`	Универсальный указатель процедуры на подпрограмму завершения, которая будет выполняться в конце асинхронного вызова. Это должно быть 0 для асинхронных вызовов без подпрограммы завершения и автоматически установлено в 0 для всех синхронных вызовов. Посмотрите `IOCompletionProcPtr` для получения информации о подпрограммах завершения.
`ioResult`	Код результата функции. Для синхронных вызовов это поле совпадает с кодом результата самого вызова функции. Для определения, когда асинхронный вызов был фактически завершен приложение может опросить это поле, это установлено в положительное число, когда вызов выполняется и получает фактический код результата, когда завершается вызов.
`ioNamePtr`	Указатель на путь. Каждый раз, когда функциональное описание указывает это `ioNamePtr` используется — очень важно ли для ввода, вывода или обоих — чтобы Вы установили это поле для указания на хранение для a `Str255` значение (если Вы используете путь), или к `NULL` (если Вы не).
`ioVRefNum`	Ссылочный номер объема, 0 для объема по умолчанию или числа диска.
`filler1`	Зарезервированный.
`ioWDIndex`	Индекс.
`ioWDProcID`	Идентификатор, который это используется для различения между обрабатыванием каталогов, установленных различными пользователями, которых необходимо установить `ioWDProcID` к подписи Вашего приложения.
`ioWDVRefNum`	Ссылочный номер объема рабочего каталога.
`filler2`	Зарезервированный.
`ioWDDirID`	Каталог ID рабочего каталога.

Доступность

Доступный в OS X v10.0 и позже.

Не доступный 64-разрядным приложениям.


      
      XCInfoPBRec

Определяет расширенный блок параметра информации о каталоге.

Объявление

Objective C

struct XCInfoPBRec { QElemPtr qLink; short qType; short ioTrap; Ptr ioCmdAddr; ProcPtr ioCompletion; volatile OSErr ioResult; StringPtr ioNamePtr; short ioVRefNum; long filler1; StringPtr ioShortNamePtr; short filler2; short ioPDType; long ioPDAuxType; long filler3[2]; long ioDirID; }; typedef struct XCInfoPBRec XCInfoPBRec; typedef XCInfoPBRec * XCInfoPBPtr;

Поля

`qLink`	Указатель на следующую запись в очереди файлового ввода-вывода. (Это поле используется внутренне Файловым менеджером для отслеживания асинхронные вызовы, ждущие выполнения.
`qType`	Тип очереди. Это поле используется внутренне Файловым менеджером.
`ioTrap`	Число прерывания вызванной функции. Это поле используется внутренне Файловым менеджером.
`ioCmdAddr`	Адрес вызванной функции. Это поле используется внутренне Файловым менеджером.
`ioCompletion`	Универсальный указатель процедуры на подпрограмму завершения, которая будет выполняться в конце асинхронного вызова. Это должно быть 0 для асинхронных вызовов без подпрограммы завершения и автоматически установлено в 0 для всех синхронных вызовов. Посмотрите `IOCompletionProcPtr` для получения информации о подпрограммах завершения.
`ioResult`	Код результата функции. Для синхронных вызовов это поле совпадает с кодом результата самого вызова функции. Для определения, когда асинхронный вызов был фактически завершен приложение может опросить это поле, это установлено в положительное число, когда вызов выполняется и получает фактический код результата, когда завершается вызов.
`ioNamePtr`	Указатель на путь. Каждый раз, когда функциональное описание указывает это `ioNamePtr` используется — очень важно ли для ввода, вывода или обоих — чтобы Вы установили это поле для указания на хранение для a `Str255` значение (если Вы используете путь), или к `NULL` (если Вы не).
`ioVRefNum`	Ссылочный номер объема, 0 для объема по умолчанию или числа диска.
`filler1`	Зарезервированный; установите это поле в 0.
`ioShortNamePtr`	Указатель на Паскаль представляет буфер в виде строки минимальных 13 байтов, который содержит краткое название файла или каталога (имя формата MS-DOS). Это поле требуется и не может быть `NULL`.
`filler2`	Зарезервированный; установите это поле в 0.
`ioPDType`	Тип файла ProDOS файла или каталога.
`ioPDAuxType`	ProDOS вспомогательный тип файла или каталога.
`filler3`	Зарезервированный; установите это поле в 0.
`ioDirID`	Каталог ID.

Обсуждение

PBGetXCatInfoSync и PBGetXCatInfoAsync функции используют этот блок параметра для возврата краткого названия и информации о ProDOS для файлов и каталогов.

Доступность

Доступный в OS X v10.0 и позже.

Не доступный 64-разрядным приложениям.


      
      XIOParam

Определяет расширенную блочную структуру параметра I/O.

Объявление

Objective C

struct XIOParam { QElemPtr qLink; short qType; short ioTrap; Ptr ioCmdAddr; IOCompletionUPP ioCompletion; volatile OSErr ioResult; StringPtr ioNamePtr; short ioVRefNum; short ioRefNum; SInt8 ioVersNum; SInt8 ioPermssn; Ptr ioMisc; Ptr ioBuffer; long ioReqCount; long ioActCount; short ioPosMode; wide ioWPosOffset; }; typedef struct XIOParam XIOParam; typedef XIOParam * XIOParamPtr;

Поля

`qLink`	Указатель на следующую запись в очереди файлового ввода-вывода. (Это поле используется внутренне Файловым менеджером для отслеживания асинхронные вызовы, ждущие выполнения.
`qType`	Тип очереди. Это поле используется внутренне Файловым менеджером.
`ioTrap`	Число прерывания вызванной функции. Это поле используется внутренне Файловым менеджером.
`ioCmdAddr`	Адрес вызванной функции. Это поле используется внутренне Файловым менеджером.
`ioCompletion`	Универсальный указатель процедуры на подпрограмму завершения, которая будет выполняться в конце асинхронного вызова. Это должно быть 0 для асинхронных вызовов без подпрограммы завершения и автоматически установлено в 0 для всех синхронных вызовов. Посмотрите `IOCompletionProcPtr` для получения информации о подпрограммах завершения.
`ioResult`	Код результата функции. Для синхронных вызовов это поле совпадает с кодом результата самого вызова функции. Для определения, когда асинхронный вызов был фактически завершен приложение может опросить это поле, это установлено в положительное число, когда вызов выполняется и получает фактический код результата, когда завершается вызов.
`ioNamePtr`	Указатель на путь. Каждый раз, когда функциональное описание указывает это `ioNamePtr` используется — очень важно ли для ввода, вывода или обоих — чтобы Вы установили это поле для указания на хранение для a `Str255` значение (если Вы используете путь), или к `NULL` (если Вы не).
`ioVRefNum`	Ссылочный номер объема, 0 для объема по умолчанию или числа диска.
`ioRefNum`	Число ссылки на файл открытого файла.
`ioVersNum`	Номер версии. Это поле больше не используется, и необходимо всегда устанавливать его в 0.
`ioPermssn`	Режим доступа. Посмотрите Константы Разрешения Доступа к файлу.
`ioMisc`	В зависимости от вызванной функции это поле содержит или логический конец файла, новый номер версии, указатель на буфер пути доступа или указатель на новый путь. Поскольку `ioMisc` имеет тип `Ptr`, необходимо будет выполнить приведение типа для интерпретации значения `ioMisc` правильно, когда это содержит конец файла (a `LongInt` значение) или номер версии (a `SignedByte` значение).
`ioBuffer`	Указатель на буфер данных, в который данные записаны `_Read` вызовы и из которого данные считаны `_Write` вызовы.
`ioReqCount`	Требуемое число байтов, которые будут считаны или записаны.
`ioActCount`	Число байтов фактически читало или записанный.
`ioPosMode`	Режим расположения (базируют расположение) для установки метки. Биты 0 и 1 из этого поля указывают, как расположить метку; можно использовать константы, описанные в Константах Режима Позиции, чтобы установить или протестировать их значение. Для функций, использующих этот блок параметра, Вы должны иметь `kUseWidePositioning` набор битов. Посмотрите Константы Большого объема для описания этого и другие константы. Можно также использовать константы, описанные в Константах Кэша, чтобы указать, кэшировать ли данные.
`ioWPosOffset`	Широкое смещение расположения, которое будет использоваться в сочетании с режимом расположения, указанным в `ioPosMode` поле.

Доступность

Доступный в OS X v10.0 и позже.

Не доступный 64-разрядным приложениям.


      
      XVolumeParam

Определяет расширенный блок параметра информации об объеме.

Объявление

Objective C

struct XVolumeParam { QElemPtr qLink; short qType; short ioTrap; Ptr ioCmdAddr; IOCompletionUPP ioCompletion; volatile OSErr ioResult; StringPtr ioNamePtr; short ioVRefNum; unsigned long ioXVersion; short ioVolIndex; unsigned long ioVCrDate; unsigned long ioVLsMod; short ioVAtrb; unsigned short ioVNmFls; unsigned short ioVBitMap; unsigned short ioAllocPtr; unsigned short ioVNmAlBlks; unsigned long ioVAlBlkSiz; unsigned long ioVClpSiz; unsigned short ioAlBlSt; unsigned long ioVNxtCNID; unsigned short ioVFrBlk; unsigned short ioVSigWord; short ioVDrvInfo; short ioVDRefNum; short ioVFSID; unsigned long ioVBkUp; short ioVSeqNum; unsigned long ioVWrCnt; unsigned long ioVFilCnt; unsigned long ioVDirCnt; long ioVFndrInfo[8]; UInt64 ioVTotalBytes; UInt64 ioVFreeBytes; }; typedef struct XVolumeParam XVolumeParam; typedef XVolumeParam * XVolumeParamPtr;

Поля

`qLink`	Указатель на следующую запись в очереди файлового ввода-вывода. (Это поле используется внутренне Файловым менеджером для отслеживания асинхронные вызовы, ждущие выполнения.
`qType`	Тип очереди. Это поле используется внутренне Файловым менеджером.
`ioTrap`	Число прерывания вызванной функции. Это поле используется внутренне Файловым менеджером.
`ioCmdAddr`	Адрес вызванной функции. Это поле используется внутренне Файловым менеджером.
`ioCompletion`	Универсальный указатель процедуры на подпрограмму завершения, которая будет выполняться в конце асинхронного вызова. Это должно быть 0 для асинхронных вызовов без подпрограммы завершения и автоматически установлено в 0 для всех синхронных вызовов. Посмотрите `IOCompletionProcPtr` для получения информации о подпрограммах завершения.
`ioResult`	Код результата функции. Для синхронных вызовов это поле совпадает с кодом результата самого вызова функции. Для определения, когда асинхронный вызов был фактически завершен приложение может опросить это поле, это установлено в положительное число, когда вызов выполняется и получает фактический код результата, когда завершается вызов.
`ioNamePtr`	Указатель на путь. Каждый раз, когда функциональное описание указывает это `ioNamePtr` используется — очень важно ли для ввода, вывода или обоих — чтобы Вы установили это поле для указания на хранение для a `Str255` значение (если Вы используете путь), или к `NULL` (если Вы не).
`ioVRefNum`	Ссылочный номер объема, 0 для объема по умолчанию или числа диска.
`ioXVersion`	Версия `XVolumeParam` блок параметра; в настоящее время это 0.
`ioVolIndex`	Индекс объема для использования с `PBXGetVolInfoSync` и `PBXGetVolInfoAsync` функции.
`ioVCrDate`	Дата и время, что объем создавался (инициализированный).
`ioVLsMod`	Дата и время, что была в последний раз изменена информация об объеме. Это поле не изменяется, когда информация записана в файл и не обязательно указывает, когда был сброшен объем.
`ioVAtrb`	Атрибуты объема. Посмотрите Константы Атрибута информации об Объеме для значений битов в этом поле.
`ioVNmFls`	Число файлов в корневом каталоге.
`ioVBitMap`	Первый блок битового массива объема.
`ioAllocPtr`	Блок, в котором запускается следующий новый файл. Используемый внутренне.
`ioVNmAlBlks`	Число блоков выделения.
`ioVAlBlkSiz`	Размер блоков выделения.
`ioVClpSiz`	Размер глыбы.
`ioAlBlSt`	Первый блок в карте объема.
`ioVNxtCNID`	Следующий неиспользованный узел каталога ID.
`ioVFrBlk`	Число неиспользованных блоков выделения.
`ioVSigWord`	Слово подписи, идентифицирующее тип объема, это - $D2D7 для объемов MFS и 4 244$ для объемов та поддержка вызовы HFS.
`ioVDrvInfo`	Число диска диска, содержащего объем.
`ioVDRefNum`	Для онлайновых объемов, ссылочного номера драйвера I/O для диска, идентифицированного `ioVDrvInfo` поле.
`ioVFSID`	Идентификатор файловой системы. Это указывает, какая файловая система обслуживает объем, это - нуль для объемов Файлового менеджера и ненулевой для объемов, обработанных внешней файловой системой.
`ioVBkUp`	Дата и время, что был в последний раз скопирован объем; если объем никогда не копировался, это 0.
`ioVSeqNum`	Используемый внутренне.
`ioVWrCnt`	Количество записи объема.
`ioVFilCnt`	Общее количество файлов на объеме.
`ioVDirCnt`	Общее количество каталогов (не включая корневой каталог) на объеме.
`ioVFndrInfo`	Информация используется Средством поиска.
`ioVTotalBytes`	Общее количество байтов на объеме.
`ioVFreeBytes`	Число свободных байтов на объеме.

Обсуждение

Функции PBXGetVolInfoSync и PBXGetVolInfoAsync используйте эту блочную структуру параметра для передачи параметров и возвращаемых значений.

Доступность

Доступный в OS X v10.0 и позже.

Не доступный 64-разрядным приложениям.

Константы

Константы длины тега AFP
Укажите продолжительность маркированной адресной информации для объемов AppleShare.

Объявление

Swift

var kAFPTagLengthIP: Int { get } var kAFPTagLengthIPPort: Int { get } var kAFPTagLengthDDP: Int { get }

Objective C

enum { kAFPTagLengthIP = 0x06, kAFPTagLengthIPPort = 0x08, kAFPTagLengthDDP = 0x06 };

Константы
- kAFPTagLengthIP
  
  kAFPTagLengthIP
  
  Длина 4-байтового IP-адреса.
  
  Доступный в OS X v10.0 и позже.
- kAFPTagLengthIPPort
  
  kAFPTagLengthIPPort
  
  Длина 4-байтового IP-адреса и 2-байтового порта.
  
  Доступный в OS X v10.0 и позже.
- kAFPTagLengthDDP
  
  kAFPTagLengthDDP
  
  Доступный в OS X v10.0 и позже.
Обсуждение

Эти константы используются в fLength поле AFPTagData структура для указания длины, в байтах, маркированной адресной информации. Эта длина включает само fLength поле.
Константы типа тега AFP
Укажите тип маркированной адресной информации для клиентов AppleShare.

Объявление

Swift

var kAFPTagTypeIP: Int { get } var kAFPTagTypeIPPort: Int { get } var kAFPTagTypeDDP: Int { get } var kAFPTagTypeDNS: Int { get }

Objective C

enum { kAFPTagTypeIP = 0x01, kAFPTagTypeIPPort = 0x02, kAFPTagTypeDDP = 0x03, kAFPTagTypeDNS = 0x04 };

Константы
- kAFPTagTypeIP
  
  kAFPTagTypeIP
  
  Основной 4-байтовый IP-адрес, старший значащий байт сначала.
  
  Доступный в OS X v10.0 и позже.
- kAFPTagTypeIPPort
  
  kAFPTagTypeIPPort
  
  4-байтовый IP-адрес и 2-байтовый номер порта, старший значащий байт сначала.
  
  Доступный в OS X v10.0 и позже.
- kAFPTagTypeDDP
  
  kAFPTagTypeDDP
  
  Доступный в OS X v10.0 и позже.
- kAFPTagTypeDNS
  
  kAFPTagTypeDNS
  
  Адрес является именем DNS в формате address:port. Общая длина имени DNS является переменной до 254 символов.
  
  Доступный в OS X v10.0 и позже.
Обсуждение

Эти константы используются в fType поле маркированной структуры адреса, AFPTagData, указать тип адреса, представленного структурой.
Флаги выделения
Укажите, как должна быть выделена новая площадь.

Объявление

Swift

typealias FSAllocationFlags = UInt16

Objective C

typedef UInt16 FSAllocationFlags; enum { kFSAllocDefaultFlags = 0x0000, kFSAllocAllOrNothingMask = 0x0001, kFSAllocContiguousMask = 0x0002, kFSAllocNoRoundUpMask = 0x0004, kFSAllocReservedMask = 0xFFF8 };

Константы
- kFSAllocDefaultFlags
  
  kFSAllocDefaultFlags
  
  Выделите как можно больше, не обязательно непрерывный.
  
  Доступный в OS X v10.0 и позже.
- kFSAllocAllOrNothingMask
  
  kFSAllocAllOrNothingMask
  
  Когда выделение должно выделить общую требуемую сумму или иначе сбой ни с чем выделенным, этот бит установлен; когда этот бит не установлен, выделение может завершиться успешно, но выделить менее, чем требуемый.
  
  Доступный в OS X v10.0 и позже.
- kFSAllocContiguousMask
  
  kFSAllocContiguousMask
  
  Когда выделение должно выделить один непрерывный диапазон пространства на объеме, этот бит установлен. Если этот бит ясен, многократные несмежные степени могут быть выделены для выполнения запроса.
  
  Доступный в OS X v10.0 и позже.
- kFSAllocNoRoundUpMask
  
  kFSAllocNoRoundUpMask
  
  Когда выделение должно не окружать к размеру глыбы, этот бит установлен. Если этот бит ясен, то дополнительная площадь вне суммы, которую требуют, может быть выделена; это сделано некоторыми форматами объема (включая HFS и HFS Плюс) для предотвращения многих маленьких запросов выделения. Если бит установлен, никакие дополнительные ассигнования не сделаны (кроме при необходимости форматом объема, таким как окружение к кратному числу размера блока выделения).
  
  Доступный в OS X v10.0 и позже.
- kFSAllocReservedMask
  
  kFSAllocReservedMask
  
  Зарезервированный; обнулить.
  
  Доступный в OS X v10.0 и позже.
Обсуждение

Если kFSAllocContiguousMask бит установлен, тогда тогда, любая недавно выделенная площадь должна быть в одной непрерывной степени (предпочтительно непрерывна с любой площадью, уже выделенной). Если kFSAllocAllOrNothingMask установлен, тогда все requestCount байты должны быть выделены для вызова для следования; если не набор, как можно больше байтов будет выделено (без ошибки). Если kFSAllocNoRoundUpMask установлен, тогда никакое дополнительное пространство не выделяется (такие как окружение к кратному числу размера глыбы); если ясный, формат объема может выделить больше площади, чем требуемый как попытка сократить фрагментацию.

Оператор импорта

Objective C

@import CoreServices;

Swift

import CoreServices

Доступность

Доступный в OS X v10.0 и позже.
Подпись объема AppleShare

Определяет подпись объема для объемов AppleShare.

Объявление

Objective C

enum { AppleShareMediaType = 'afpm' };
Константы метода аутентификации
Определите методы входа в систему для удаленных объемов.

Объявление

Swift

var kNoUserAuthentication: Int { get } var kPassword: Int { get } var kEncryptPassword: Int { get } var kTwoWayEncryptPassword: Int { get }

Objective C

enum { kNoUserAuthentication = 1, kPassword = 2, kEncryptPassword = 3, kTwoWayEncryptPassword = 6 };

Константы
- kNoUserAuthentication
  
  kNoUserAuthentication
  
  Никакой пароль.
  
  Доступный в OS X v10.0 и позже.
- kPassword
  
  kPassword
  
  8-байтовый пароль.
  
  Доступный в OS X v10.0 и позже.
- kEncryptPassword
  
  kEncryptPassword
  
  Зашифрованный 8-байтовый пароль.
  
  Доступный в OS X v10.0 и позже.
- kTwoWayEncryptPassword
  
  kTwoWayEncryptPassword
  
  Двухстороннее случайное шифрование.
  
  Доступный в OS X v10.0 и позже.
Обсуждение

Эти константы используются в uamType поле AFPVolMountInfo структура и в ioObjType поле блока параметра передало PBHGetLogInInfoSync и PBHGetLogInInfoAsync функции для указания типа аутентификации пользователя, используемой удаленным объемом.
Константы кэша
Укажите, должны ли кэшироваться данные.

Объявление

Swift

var pleaseCacheBit: Int { get } var pleaseCacheMask: Int { get } var noCacheBit: Int { get } var noCacheMask: Int { get } var rdVerifyBit: Int { get } var rdVerifyMask: Int { get } var rdVerify: Int { get } var forceReadBit: Int { get } var forceReadMask: Int { get } var newLineBit: Int { get } var newLineMask: Int { get } var newLineCharMask: Int { get }

Objective C

enum { pleaseCacheBit = 4, pleaseCacheMask = 0x0010, noCacheBit = 5, noCacheMask = 0x0020, rdVerifyBit = 6, rdVerifyMask = 0x0040, rdVerify = 64, forceReadBit = 6, forceReadMask = 0x0040, newLineBit = 7, newLineMask = 0x0080, newLineCharMask = 0xFF00 };

Константы
- pleaseCacheBit
  
  pleaseCacheBit
  
  Указывает, что должны кэшироваться данные.
  
  Доступный в OS X v10.0 и позже.
- pleaseCacheMask
  
  pleaseCacheMask
  
  Запросы, что данные кэшироваться, если это возможно. Если Вы читаете или пишете ту же часть файла многократно, необходимо кэшировать чтения и записи.
  
  Доступный в OS X v10.0 и позже.
- noCacheBit
  
  noCacheBit
  
  Указывает, что не должны кэшироваться данные.
  
  Доступный в OS X v10.0 и позже.
- noCacheMask
  
  noCacheMask
  
  Запросы, что данные не кэшироваться, если это возможно. Если Вы читаете или пишете данные из файла только один раз, Вы не должны кэшировать чтения и записи.
  
  Доступный в OS X v10.0 и позже.
- rdVerifyBit
  
  rdVerifyBit
  
  Указывает, что все чтения должны прибыть из источника и быть проверены по данным в памяти.
  
  Доступный в OS X v10.0 и позже.
- rdVerifyMask
  
  rdVerifyMask
  
  Запросы, что все чтения (не записи) прибывают непосредственно из источника и проверяются по данным в памяти. Это сбрасывает кэш и отправляет все запросы чтения к источнику данных.
  
  Доступный в OS X v10.0 и позже.
- rdVerify
  
  rdVerify
  
  Это - старое название rdVerifyMask. Оба запроса, что все чтения прибывают непосредственно из источника данных и сравниваются с данными в памяти.
  
  Доступный в OS X v10.0 и позже.
- forceReadBit
  
  forceReadBit
  
  Указывает, что чтения должны прибыть из диска.
  
  Доступный в OS X v10.0 и позже.
- forceReadMask
  
  forceReadMask
  
  Силы читают из диска, обходя все кэши. Клиенты могут использовать это, чтобы проверить, что данные хранятся правильно на носителях (например, для проверки после записи) путем чтения данных в различный буфер при установке бита, и затем сравнении недавно считанных данных с ранее записанными данными.
  
  forceReadMask совпадает с rdVerifyMask используемый в более старом APIs. Фактическая реализация rdVerifyMask в более старом APIs фактически вызвал “поведение” чтения силы, и только сравнил данные в частичных секторах. FSReadFork очищает это поведение, всегда позволяя клиенту сделать все сравнивание.
  
  Доступный в OS X v10.0 и позже.
- newLineBit
  
  newLineBit
  
  Указывает, что режим новой строки должен использоваться для чтений.
  
  Доступный в OS X v10.0 и позже.
- newLineMask
  
  newLineMask
  Запросы, что режим новой строки использоваться для чтений. Когда одному из следующих условий отвечают, в режиме новой строки останавливается чтение:
  
  Требуемое число байтов было считано.
  
  Конец файла достигнут.
  
  Символ новой строки был считан. Если символ новой строки будет найден, то это будет последний знак, помещенный в буфер, и число чтения байтов будет включать его.
  Доступный в OS X v10.0 и позже.
- newLineCharMask
  
  newLineCharMask
  
  Доступный в OS X v10.0 и позже.
Обсуждение

Для FSReadFork и FSWriteFork функции и их параметр блокируют эквиваленты, можно добавить любой из pleaseCacheMask или noCacheMask константы к одной из Констант Режима Позиции, чтобы подсказать, должны ли данные кэшироваться или нет.

pleaseCacheBit и noCacheBit являются взаимоисключающими, и только один должен быть установлен за один раз. Если никакой бит не установлен, программа указала, что это не заботится, кэшируются ли данные или нет.
Растровые константы информации о каталоге
Укажите что файл или информация о ветвлении, чтобы получить или установить.

Объявление

Swift

var kFSCatInfoNone: Int { get } var kFSCatInfoTextEncoding: Int { get } var kFSCatInfoNodeFlags: Int { get } var kFSCatInfoVolume: Int { get } var kFSCatInfoParentDirID: Int { get } var kFSCatInfoNodeID: Int { get } var kFSCatInfoCreateDate: Int { get } var kFSCatInfoContentMod: Int { get } var kFSCatInfoAttrMod: Int { get } var kFSCatInfoAccessDate: Int { get } var kFSCatInfoBackupDate: Int { get } var kFSCatInfoPermissions: Int { get } var kFSCatInfoFinderInfo: Int { get } var kFSCatInfoFinderXInfo: Int { get } var kFSCatInfoValence: Int { get } var kFSCatInfoDataSizes: Int { get } var kFSCatInfoRsrcSizes: Int { get } var kFSCatInfoSharingFlags: Int { get } var kFSCatInfoUserPrivs: Int { get } var kFSCatInfoUserAccess: Int { get } var kFSCatInfoSetOwnership: Int { get } var kFSCatInfoAllDates: Int { get } var kFSCatInfoGettableInfo: Int { get } var kFSCatInfoSettableInfo: Int { get } var kFSCatInfoReserved: Int { get }

Objective C

enum { kFSCatInfoNone = 0x00000000, kFSCatInfoTextEncoding = 0x00000001, kFSCatInfoNodeFlags = 0x00000002, kFSCatInfoVolume = 0x00000004, kFSCatInfoParentDirID = 0x00000008, kFSCatInfoNodeID = 0x00000010, kFSCatInfoCreateDate = 0x00000020, kFSCatInfoContentMod = 0x00000040, kFSCatInfoAttrMod = 0x00000080, kFSCatInfoAccessDate = 0x00000100, kFSCatInfoBackupDate = 0x00000200, kFSCatInfoPermissions = 0x00000400, kFSCatInfoFinderInfo = 0x00000800, kFSCatInfoFinderXInfo = 0x00001000, kFSCatInfoValence = 0x00002000, kFSCatInfoDataSizes = 0x00004000, kFSCatInfoRsrcSizes = 0x00008000, kFSCatInfoSharingFlags = 0x00010000, kFSCatInfoUserPrivs = 0x00020000, kFSCatInfoUserAccess = 0x00080000, kFSCatInfoSetOwnership = 0x00100000, kFSCatInfoAllDates = 0x000003E0, kFSCatInfoGettableInfo = 0x0003FFFF, kFSCatInfoSettableInfo = 0x00001FE3, kFSCatInfoReserved = 0xFFFC0000 };

Константы
- kFSCatInfoNone
  
  kFSCatInfoNone
  
  Никакая информация о каталоге.
  
  Доступный в OS X v10.0 и позже.
- kFSCatInfoTextEncoding
  
  kFSCatInfoTextEncoding
  
  Получите или установите текст, кодирующий подсказку, в textEncodingHint поле.
  
  Доступный в OS X v10.0 и позже.
- kFSCatInfoNodeFlags
  
  kFSCatInfoNodeFlags
  
  Получите или установите флаги узла каталога. В настоящее время можно только установить биты 0 и 4. Посмотрите Флаги Узла информации о Каталоге для получения дополнительной информации об этих флагах.
  
  Доступный в OS X v10.0 и позже.
- kFSCatInfoVolume
  
  kFSCatInfoVolume
  
  Получите ссылочный номер объема объема, на котором находится файл или каталог.
  
  Доступный в OS X v10.0 и позже.
- kFSCatInfoParentDirID
  
  kFSCatInfoParentDirID
  
  Получите родительский каталог ID.
  
  Доступный в OS X v10.0 и позже.
- kFSCatInfoNodeID
  
  kFSCatInfoNodeID
  
  Получите файл или каталог ID.
  
  Доступный в OS X v10.0 и позже.
- kFSCatInfoCreateDate
  
  kFSCatInfoCreateDate
  
  Получите или установите дату создания.
  
  Доступный в OS X v10.0 и позже.
- kFSCatInfoContentMod
  
  kFSCatInfoContentMod
  
  Получите или назначьте дату, что были в последний раз изменены ветвь ресурсов или ветвь данных.
  
  Доступный в OS X v10.0 и позже.
- kFSCatInfoAttrMod
  
  kFSCatInfoAttrMod
  
  Получите или назначьте дату, что были в последний раз изменены атрибут или именованное ветвление.
  
  Доступный в OS X v10.0 и позже.
- kFSCatInfoAccessDate
  
  kFSCatInfoAccessDate
  
  Получите или назначьте дату, что к ветвлению или файлу в последний раз получили доступ.
  
  Доступный в OS X v10.0 и позже.
- kFSCatInfoBackupDate
  
  kFSCatInfoBackupDate
  
  Получите или назначьте дату, что были в последний раз скопированы ветвление или файл.
  
  Доступный в OS X v10.0 и позже.
- kFSCatInfoPermissions
  
  kFSCatInfoPermissions
  
  Получите или установите файл или полномочия ветвления.
  
  Доступный в OS X v10.0 и позже.
- kFSCatInfoFinderInfo
  
  kFSCatInfoFinderInfo
  
  Получите или установите файл или информацию о Средстве поиска ветвления.
  
  Доступный в OS X v10.0 и позже.
- kFSCatInfoFinderXInfo
  
  kFSCatInfoFinderXInfo
  
  Получите или установите файл или расширенную информацию о Средстве поиска ветвления.
  
  Доступный в OS X v10.0 и позже.
- kFSCatInfoValence
  
  kFSCatInfoValence
  
  Для папок только, получите валентность папки. Для файлов это - нуль.
  
  Доступный в OS X v10.0 и позже.
- kFSCatInfoDataSizes
  
  kFSCatInfoDataSizes
  
  Получите логический и физический размер ветви данных.
  
  Доступный в OS X v10.0 и позже.
- kFSCatInfoRsrcSizes
  
  kFSCatInfoRsrcSizes
  
  Получите логический и физический размер ветви ресурсов.
  
  Доступный в OS X v10.0 и позже.
- kFSCatInfoSharingFlags
  
  kFSCatInfoSharingFlags
  
  Получите ветвление или совместное использование файла флагов: kioFlAttribMountedBit, kioFlAttribSharePointBit. Посмотрите Константы Атрибута файла для получения дополнительной информации об этих битах.
  
  Доступный в OS X v10.0 и позже.
- kFSCatInfoUserPrivs
  
  kFSCatInfoUserPrivs
  
  Получите полномочия пользователя файла.
  
  Доступный в OS X v10.0 и позже.
- kFSCatInfoUserAccess
  
  kFSCatInfoUserAccess
  
  Доступный в OS X v10.1 и позже.
- kFSCatInfoSetOwnership
  
  kFSCatInfoSetOwnership
  
  Попытайтесь установить пользователя и группу файла (UID и GID). Если Файловый менеджер не может установить пользователя или группу ID, сбои вызова. (Только OS X).
  
  Доступный в OS X v10.3 и позже.
- kFSCatInfoAllDates
  
  kFSCatInfoAllDates
  
  Получите или установите всю информацию о дате для ветвления или файла: дата создания, даты модификации, дата доступа, копирует дату и т.д.
  
  Доступный в OS X v10.0 и позже.
- kFSCatInfoGettableInfo
  
  kFSCatInfoGettableInfo
  
  Получите все доступные данные.
  
  Доступный в OS X v10.0 и позже.
- kFSCatInfoSettableInfo
  
  kFSCatInfoSettableInfo
  
  Установите все устанавливаемые данные. Это включает флаги, даты, полномочия, информацию Средства поиска и текст, кодирующий подсказку.
  
  Доступный в OS X v10.0 и позже.
- kFSCatInfoReserved
  
  kFSCatInfoReserved
  
  Представляет в настоящее время резервирующиеся биты.
  
  Доступный в OS X v10.0 и позже.
Обсуждение

Эти константы используются в FSCatalogInfoBitmap введите для указания что файл или информация о ветвлении, чтобы получить или установить. Если используется с FSGetCatalogInfo или FSGetCatalogInfoBulk функции, эти константы говорят Файловый менеджер который поля возвратить информацию в. Если используется с FSSetCatalogInfo функция, эти константы говорят Файловый менеджер, какие поля Вы заполнили со значениями, которые это должно использовать для изменения ветвления или информации о каталоге файла.
Флаги узла информации о каталоге
Определите значения, используемые в nodeFlags поле FSCatalogInfo структура.

Объявление

Swift

var kFSNodeLockedBit: Int { get } var kFSNodeLockedMask: Int { get } var kFSNodeResOpenBit: Int { get } var kFSNodeResOpenMask: Int { get } var kFSNodeDataOpenBit: Int { get } var kFSNodeDataOpenMask: Int { get } var kFSNodeIsDirectoryBit: Int { get } var kFSNodeIsDirectoryMask: Int { get } var kFSNodeCopyProtectBit: Int { get } var kFSNodeCopyProtectMask: Int { get } var kFSNodeForkOpenBit: Int { get } var kFSNodeForkOpenMask: Int { get } var kFSNodeHardLinkBit: Int { get } var kFSNodeHardLinkMask: Int { get }

Objective C

enum { kFSNodeLockedBit = 0, kFSNodeLockedMask = 0x0001, kFSNodeResOpenBit = 2, kFSNodeResOpenMask = 0x0004, kFSNodeDataOpenBit = 3, kFSNodeDataOpenMask = 0x0008, kFSNodeIsDirectoryBit = 4, kFSNodeIsDirectoryMask = 0x0010, kFSNodeCopyProtectBit = 6, kFSNodeCopyProtectMask = 0x0040, kFSNodeForkOpenBit = 7, kFSNodeForkOpenMask = 0x0080, kFSNodeHardLinkBit = 8, kFSNodeHardLinkMask = 0x00000100 };

Константы
- kFSNodeLockedBit
  
  kFSNodeLockedBit
  
  Набор, если заблокирован файл или каталог.
  
  Доступный в OS X v10.0 и позже.
- kFSNodeLockedMask
  
  kFSNodeLockedMask
  
  Указывает, что заблокирован файл или каталог.
  
  Доступный в OS X v10.0 и позже.
- kFSNodeResOpenBit
  
  kFSNodeResOpenBit
  
  Набор, если ветвь ресурсов открыта.
  
  Доступный в OS X v10.0 и позже.
- kFSNodeResOpenMask
  
  kFSNodeResOpenMask
  
  Указывает, что ветвь ресурсов открыта.
  
  Доступный в OS X v10.0 и позже.
- kFSNodeDataOpenBit
  
  kFSNodeDataOpenBit
  
  Набор, если ветвь данных открыта.
  
  Доступный в OS X v10.0 и позже.
- kFSNodeDataOpenMask
  
  kFSNodeDataOpenMask
  
  Указывает, что ветвь данных открыта.
  
  Доступный в OS X v10.0 и позже.
- kFSNodeIsDirectoryBit
  
  kFSNodeIsDirectoryBit
  
  Набор, если объект является каталогом.
  
  Доступный в OS X v10.0 и позже.
- kFSNodeIsDirectoryMask
  
  kFSNodeIsDirectoryMask
  
  Указывает, что объект является каталогом.
  
  Доступный в OS X v10.0 и позже.
- kFSNodeCopyProtectBit
  
  kFSNodeCopyProtectBit
  
  Набор файла или каталога защищен от копирования.
  
  Доступный в OS X v10.0 и позже.
- kFSNodeCopyProtectMask
  
  kFSNodeCopyProtectMask
  
  Указывает, что файл или каталог защищен от копирования.
  
  Доступный в OS X v10.0 и позже.
- kFSNodeForkOpenBit
  
  kFSNodeForkOpenBit
  
  Набор, если файл или каталог имеет какое-либо открытое ветвление.
  
  Доступный в OS X v10.0 и позже.
- kFSNodeForkOpenMask
  
  kFSNodeForkOpenMask
  
  Указывает, что файл или каталог имеет открытое ветвление любого типа.
  
  Доступный в OS X v10.0 и позже.
- kFSNodeHardLinkBit
  
  kFSNodeHardLinkBit
  
  Доступный в OS X v10.2 и позже.
- kFSNodeHardLinkMask
  
  kFSNodeHardLinkMask
  
  Доступный в OS X v10.2 и позже.
Флаги совместного пользования информацией каталога
Укажите состояние общего каталога.

Объявление

Swift

var kFSNodeInSharedBit: Int { get } var kFSNodeInSharedMask: Int { get } var kFSNodeIsMountedBit: Int { get } var kFSNodeIsMountedMask: Int { get } var kFSNodeIsSharePointBit: Int { get } var kFSNodeIsSharePointMask: Int { get }

Objective C

enum { kFSNodeInSharedBit = 2, kFSNodeInSharedMask = 0x0004, kFSNodeIsMountedBit = 3, kFSNodeIsMountedMask = 0x0008, kFSNodeIsSharePointBit = 5, kFSNodeIsSharePointMask = 0x0020 };

Константы
- kFSNodeInSharedBit
  
  kFSNodeInSharedBit
  
  Набор, если каталог в точке доли.
  
  Доступный в OS X v10.0 и позже.
- kFSNodeInSharedMask
  
  kFSNodeInSharedMask
  
  Указывает, что каталог в точке доли.
  
  Доступный в OS X v10.0 и позже.
- kFSNodeIsMountedBit
  
  kFSNodeIsMountedBit
  
  Набор, если каталог является точкой доли, в настоящее время монтируемой некоторым пользователем.
  
  Доступный в OS X v10.0 и позже.
- kFSNodeIsMountedMask
  
  kFSNodeIsMountedMask
  
  Указывает, что каталог является точкой доли, в настоящее время монтируемой некоторым пользователем.
  
  Доступный в OS X v10.0 и позже.
- kFSNodeIsSharePointBit
  
  kFSNodeIsSharePointBit
  
  Набор, если каталог является точкой доли (экспортируемый объем).
  
  Доступный в OS X v10.0 и позже.
- kFSNodeIsSharePointMask
  
  kFSNodeIsSharePointMask
  
  Указывает, что каталог является точкой доли (экспортируемый объем).
  
  Доступный в OS X v10.0 и позже.
Обсуждение

FSCatalogInfo структура использует эти константы в sharingFlags поле.
Биты поиска каталога
Укажите критерии поиска каталога.

Объявление

Swift

var fsSBPartialNameBit: Int { get } var fsSBFullNameBit: Int { get } var fsSBFlAttribBit: Int { get } var fsSBFlFndrInfoBit: Int { get } var fsSBFlLgLenBit: Int { get } var fsSBFlPyLenBit: Int { get } var fsSBFlRLgLenBit: Int { get } var fsSBFlRPyLenBit: Int { get } var fsSBFlCrDatBit: Int { get } var fsSBFlMdDatBit: Int { get } var fsSBFlBkDatBit: Int { get } var fsSBFlXFndrInfoBit: Int { get } var fsSBFlParIDBit: Int { get } var fsSBNegateBit: Int { get } var fsSBDrUsrWdsBit: Int { get } var fsSBDrNmFlsBit: Int { get } var fsSBDrCrDatBit: Int { get } var fsSBDrMdDatBit: Int { get } var fsSBDrBkDatBit: Int { get } var fsSBDrFndrInfoBit: Int { get } var fsSBDrParIDBit: Int { get }

Objective C

enum { fsSBPartialNameBit = 0, fsSBFullNameBit = 1, fsSBFlAttribBit = 2, fsSBFlFndrInfoBit = 3, fsSBFlLgLenBit = 5, fsSBFlPyLenBit = 6, fsSBFlRLgLenBit = 7, fsSBFlRPyLenBit = 8, fsSBFlCrDatBit = 9, fsSBFlMdDatBit = 10, fsSBFlBkDatBit = 11, fsSBFlXFndrInfoBit = 12, fsSBFlParIDBit = 13, fsSBNegateBit = 14, fsSBDrUsrWdsBit = 3, fsSBDrNmFlsBit = 4, fsSBDrCrDatBit = 9, fsSBDrMdDatBit = 10, fsSBDrBkDatBit = 11, fsSBDrFndrInfoBit = 12, fsSBDrParIDBit = 13 };

Константы
- fsSBPartialNameBit
  
  fsSBPartialNameBit
  
  Указывает поиск подстрокой имени.
  
  Доступный в OS X v10.0 и позже.
- fsSBFullNameBit
  
  fsSBFullNameBit
  
  Указывает поиск полным именем.
  
  Доступный в OS X v10.0 и позже.
- fsSBFlAttribBit
  
  fsSBFlAttribBit
  
  Указывает поиск атрибутами файла или каталога.
  
  Доступный в OS X v10.0 и позже.
- fsSBFlFndrInfoBit
  
  fsSBFlFndrInfoBit
  
  Поскольку файлы только указывают поиск информацией Средства поиска файла.
  
  Доступный в OS X v10.0 и позже.
- fsSBFlLgLenBit
  
  fsSBFlLgLenBit
  
  Для файлов только; указывает поиск логической длиной ветви данных.
  
  Доступный в OS X v10.0 и позже.
- fsSBFlPyLenBit
  
  fsSBFlPyLenBit
  
  Для файлов только; указывает поиск физической длиной ветви данных.
  
  Доступный в OS X v10.0 и позже.
- fsSBFlRLgLenBit
  
  fsSBFlRLgLenBit
  
  Для файлов только; указывает поиск логической длины ветви ресурсов.
  
  Доступный в OS X v10.0 и позже.
- fsSBFlRPyLenBit
  
  fsSBFlRPyLenBit
  
  Для файлов только; указывает поиск физической длиной ветви ресурсов.
  
  Доступный в OS X v10.0 и позже.
- fsSBFlCrDatBit
  
  fsSBFlCrDatBit
  
  Поскольку файлы только указывают поиск датой создания файла.
  
  Доступный в OS X v10.0 и позже.
- fsSBFlMdDatBit
  
  fsSBFlMdDatBit
  
  Поскольку файлы только указывают поиск датой последнего изменения файла.
  
  Доступный в OS X v10.0 и позже.
- fsSBFlBkDatBit
  
  fsSBFlBkDatBit
  
  Поскольку файлы только указывают поиск датой последнего резервного копирования файла.
  
  Доступный в OS X v10.0 и позже.
- fsSBFlXFndrInfoBit
  
  fsSBFlXFndrInfoBit
  
  Поскольку файлы только указывают поиск расширенной информацией Средства поиска файла.
  
  Доступный в OS X v10.0 и позже.
- fsSBFlParIDBit
  
  fsSBFlParIDBit
  
  Поскольку файлы только указывают поиск родительским ID файла.
  
  Доступный в OS X v10.0 и позже.
- fsSBNegateBit
  
  fsSBNegateBit
  
  Указывает поиск всех несоответствий. Т.е. если файл или каталог соответствует один из других указанных критериев, это не возвращается; если это не соответствует ни одного из указанных критериев, это возвращается.
  
  Доступный в OS X v10.0 и позже.
- fsSBDrUsrWdsBit
  
  fsSBDrUsrWdsBit
  
  Поскольку каталоги только указывают поиск информацией Средства поиска каталога.
  
  Доступный в OS X v10.0 и позже.
- fsSBDrNmFlsBit
  
  fsSBDrNmFlsBit
  
  Для каталогов только; указывает поиск числом файлов в каталоге.
  
  Доступный в OS X v10.0 и позже.
- fsSBDrCrDatBit
  
  fsSBDrCrDatBit
  
  Поскольку каталоги только указывают поиск датой создания каталога.
  
  Доступный в OS X v10.0 и позже.
- fsSBDrMdDatBit
  
  fsSBDrMdDatBit
  
  Поскольку каталоги только указывают поиск датой последнего изменения каталога.
  
  Доступный в OS X v10.0 и позже.
- fsSBDrBkDatBit
  
  fsSBDrBkDatBit
  
  Поскольку каталоги только указывают поиск датой последнего резервного копирования каталога.
  
  Доступный в OS X v10.0 и позже.
- fsSBDrFndrInfoBit
  
  fsSBDrFndrInfoBit
  
  Поскольку каталоги только указывают поиск дополнительной информацией Средства поиска каталога.
  
  Доступный в OS X v10.0 и позже.
- fsSBDrParIDBit
  
  fsSBDrParIDBit
  
  Поскольку каталоги только указывают поиск родительским ID каталога.
  
  Доступный в OS X v10.0 и позже.
Константы поиска каталога
Укажите который поля информации о каталоге использовать в качестве критериев поиска.

Объявление

Swift

var fsSBNodeID: Int { get } var fsSBAttributeModDate: Int { get } var fsSBAccessDate: Int { get } var fsSBPermissions: Int { get } var fsSBNodeIDBit: Int { get } var fsSBAttributeModDateBit: Int { get } var fsSBAccessDateBit: Int { get } var fsSBPermissionsBit: Int { get }

Objective C

enum { fsSBNodeID = 0x00008000, fsSBAttributeModDate = 0x00010000, fsSBAccessDate = 0x00020000, fsSBPermissions = 0x00040000, fsSBNodeIDBit = 15, fsSBAttributeModDateBit = 16, fsSBAccessDateBit = 17, fsSBPermissionsBit = 18 };

Константы
- fsSBNodeID
  
  fsSBNodeID
  
  Поиск диапазоном узла каталога ID.
  
  Доступный в OS X v10.0 и позже.
- fsSBAttributeModDate
  
  fsSBAttributeModDate
  
  Поиск диапазоном атрибута (ветвление) дата модификации.
  
  Доступный в OS X v10.0 и позже.
- fsSBAccessDate
  
  fsSBAccessDate
  
  Поиск диапазоном даты доступа.
  
  Доступный в OS X v10.0 и позже.
- fsSBPermissions
  
  fsSBPermissions
  
  Поиск значением или маской полномочий.
  
  Доступный в OS X v10.0 и позже.
- fsSBNodeIDBit
  
  fsSBNodeIDBit
  
  Доступный в OS X v10.0 и позже.
- fsSBAttributeModDateBit
  
  fsSBAttributeModDateBit
  
  Доступный в OS X v10.0 и позже.
- fsSBAccessDateBit
  
  fsSBAccessDateBit
  
  Доступный в OS X v10.0 и позже.
- fsSBPermissionsBit
  
  fsSBPermissionsBit
  
  Доступный в OS X v10.0 и позже.
Маски поиска каталога
Укажите критерии поиска каталога.

Объявление

Swift

var fsSBPartialName: Int { get } var fsSBFullName: Int { get } var fsSBFlAttrib: Int { get } var fsSBFlFndrInfo: Int { get } var fsSBFlLgLen: Int { get } var fsSBFlPyLen: Int { get } var fsSBFlRLgLen: Int { get } var fsSBFlRPyLen: Int { get } var fsSBFlCrDat: Int { get } var fsSBFlMdDat: Int { get } var fsSBFlBkDat: Int { get } var fsSBFlXFndrInfo: Int { get } var fsSBFlParID: Int { get } var fsSBNegate: Int { get } var fsSBDrUsrWds: Int { get } var fsSBDrNmFls: Int { get } var fsSBDrCrDat: Int { get } var fsSBDrMdDat: Int { get } var fsSBDrBkDat: Int { get } var fsSBDrFndrInfo: Int { get } var fsSBDrParID: Int { get }

Objective C

enum { fsSBPartialName = 1, fsSBFullName = 2, fsSBFlAttrib = 4, fsSBFlFndrInfo = 8, fsSBFlLgLen = 32, fsSBFlPyLen = 64, fsSBFlRLgLen = 128, fsSBFlRPyLen = 256, fsSBFlCrDat = 512, fsSBFlMdDat = 1024, fsSBFlBkDat = 2048, fsSBFlXFndrInfo = 4096, fsSBFlParID = 8192, fsSBNegate = 16384, fsSBDrUsrWds = 8, fsSBDrNmFls = 16, fsSBDrCrDat = 512, fsSBDrMdDat = 1024, fsSBDrBkDat = 2048, fsSBDrFndrInfo = 4096, fsSBDrParID = 8192 };

Константы
- fsSBPartialName
  
  fsSBPartialName
  
  Поиск подстрокой имени.
  
  Доступный в OS X v10.0 и позже.
- fsSBFullName
  
  fsSBFullName
  
  Поиск полным именем.
  
  Доступный в OS X v10.0 и позже.
- fsSBFlAttrib
  
  fsSBFlAttrib
  
  Поиск атрибутами файла или каталога. Можно использовать атрибуты, чтобы указать поиск каталога, или для файла или каталога, заблокированного программным обеспечением.
  
  Доступный в OS X v10.0 и позже.
- fsSBFlFndrInfo
  
  fsSBFlFndrInfo
  
  Поскольку файлы только ищут информацией Средства поиска файла.
  
  Доступный в OS X v10.0 и позже.
- fsSBFlLgLen
  
  fsSBFlLgLen
  
  Для файлов только; поиск логической длиной ветви данных.
  
  Доступный в OS X v10.0 и позже.
- fsSBFlPyLen
  
  fsSBFlPyLen
  
  Для файлов только; поиск физической длиной ветви данных.
  
  Доступный в OS X v10.0 и позже.
- fsSBFlRLgLen
  
  fsSBFlRLgLen
  
  Для файлов только; ищите логическую длину ветви ресурсов.
  
  Доступный в OS X v10.0 и позже.
- fsSBFlRPyLen
  
  fsSBFlRPyLen
  
  Для файлов только; поиск физической длиной ветви ресурсов.
  
  Доступный в OS X v10.0 и позже.
- fsSBFlCrDat
  
  fsSBFlCrDat
  
  Поскольку файлы только ищут датой создания файла.
  
  Доступный в OS X v10.0 и позже.
- fsSBFlMdDat
  
  fsSBFlMdDat
  
  Поскольку файлы только ищут датой последнего изменения файла.
  
  Доступный в OS X v10.0 и позже.
- fsSBFlBkDat
  
  fsSBFlBkDat
  
  Поскольку файлы только ищут датой последнего резервного копирования файла.
  
  Доступный в OS X v10.0 и позже.
- fsSBFlXFndrInfo
  
  fsSBFlXFndrInfo
  
  Поскольку файлы только ищут расширенной информацией Средства поиска файла.
  
  Доступный в OS X v10.0 и позже.
- fsSBFlParID
  
  fsSBFlParID
  
  Поскольку файлы только ищут родительским ID файла.
  
  Доступный в OS X v10.0 и позже.
- fsSBNegate
  
  fsSBNegate
  
  Поиск всех несоответствий. Т.е. если файл или каталог соответствует один из других указанных критериев, это не возвращается; если это не соответствует ни одного из указанных критериев, это возвращается.
  
  Доступный в OS X v10.0 и позже.
- fsSBDrUsrWds
  
  fsSBDrUsrWds
  
  Поскольку каталоги только ищут информацией Средства поиска каталога.
  
  Доступный в OS X v10.0 и позже.
- fsSBDrNmFls
  
  fsSBDrNmFls
  
  Для каталогов только; поиск числом файлов в каталоге.
  
  Доступный в OS X v10.0 и позже.
- fsSBDrCrDat
  
  fsSBDrCrDat
  
  Поскольку каталоги только ищут датой создания каталога.
  
  Доступный в OS X v10.0 и позже.
- fsSBDrMdDat
  
  fsSBDrMdDat
  
  Поскольку каталоги только ищут датой последнего изменения каталога.
  
  Доступный в OS X v10.0 и позже.
- fsSBDrBkDat
  
  fsSBDrBkDat
  
  Поскольку каталоги только ищут датой последнего резервного копирования каталога.
  
  Доступный в OS X v10.0 и позже.
- fsSBDrFndrInfo
  
  fsSBDrFndrInfo
  
  Поскольку каталоги только ищут дополнительной информацией Средства поиска каталога.
  
  Доступный в OS X v10.0 и позже.
- fsSBDrParID
  
  fsSBDrParID
  
  Поскольку каталоги только ищут родительским ID каталога.
  
  Доступный в OS X v10.0 и позже.
Обсуждение

Используйте эти константы в ioSearchBits поле PBCatSearchSync и PBCatSearchAsync функции для указания критериев поиска.
Расширенный объем AFP, монтирующий информационный флаг
Указывает флаг, используемый в extendedFlags поле AFPXVolMountInfo структура.

Объявление

Swift

var kAFPExtendedFlagsAlternateAddressMask: Int { get }

Objective C

enum { kAFPExtendedFlagsAlternateAddressMask = 1 };

Константы
- kAFPExtendedFlagsAlternateAddressMask
  
  kAFPExtendedFlagsAlternateAddressMask
  
  Указывает что alternateAddressOffset поле в AFPXVolMountInfo запись используется.
  
  Доступный в OS X v10.0 и позже.
Обсуждение

Посмотрите AFPXVolMountInfo структура для получения дополнительной информации.
Расширенные атрибуты объема
Опишите расширенные атрибуты объема.

Объявление

Swift

var bIsEjectable: Int { get } var bSupportsHFSPlusAPIs: Int { get } var bSupportsFSCatalogSearch: Int { get } var bSupportsFSExchangeObjects: Int { get } var bSupports2TBFiles: Int { get } var bSupportsLongNames: Int { get } var bSupportsMultiScriptNames: Int { get } var bSupportsNamedForks: Int { get } var bSupportsSubtreeIterators: Int { get } var bL2PCanMapFileBlocks: Int { get } var bParentModDateChanges: Int { get } var bAncestorModDateChanges: Int { get } var bSupportsSymbolicLinks: Int { get } var bIsAutoMounted: Int { get } var bAllowCDiDataHandler: Int { get } var bSupportsExclusiveLocks: Int { get } var bSupportsJournaling: Int { get } var bNoVolumeSizes: Int { get } var bIsOnInternalBus: Int { get } var bIsCaseSensitive: Int { get } var bIsCasePreserving: Int { get } var bDoNotDisplay: Int { get } var bIsRemovable: Int { get } var bNoRootTimes: Int { get } var bIsOnExternalBus: Int { get } var bSupportsExtendedFileSecurity: Int { get }

Objective C

enum { bIsEjectable = 0, bSupportsHFSPlusAPIs = 1, bSupportsFSCatalogSearch = 2, bSupportsFSExchangeObjects = 3, bSupports2TBFiles = 4, bSupportsLongNames = 5, bSupportsMultiScriptNames = 6, bSupportsNamedForks = 7, bSupportsSubtreeIterators = 8, bL2PCanMapFileBlocks = 9, bParentModDateChanges = 10, bAncestorModDateChanges = 11, bSupportsSymbolicLinks = 13, bIsAutoMounted = 14, bAllowCDiDataHandler = 17, bSupportsExclusiveLocks = 18, bSupportsJournaling = 19, bNoVolumeSizes = 20, bIsOnInternalBus = 21, bIsCaseSensitive = 22, bIsCasePreserving = 23, bDoNotDisplay = 24, bIsRemovable = 25, bNoRootTimes = 26, bIsOnExternalBus = 27, bSupportsExtendedFileSecurity = 28 };

Константы
- bIsEjectable
  
  bIsEjectable
  
  Объем находится в выбрасываемом дисководе.
  
  Доступный в OS X v10.0 и позже.
- bSupportsHFSPlusAPIs
  
  bSupportsHFSPlusAPIs
  
  Объем поддерживает HFS Плюс APIs непосредственно, т.е. Файловый менеджер не эмулирует их.
  
  Доступный в OS X v10.0 и позже.
- bSupportsFSCatalogSearch
  
  bSupportsFSCatalogSearch
  
  Объем поддерживает FSCatalogSearch работа.
  
  Доступный в OS X v10.0 и позже.
- bSupportsFSExchangeObjects
  
  bSupportsFSExchangeObjects
  
  Объем поддерживает FSExchangeObjects функция.
  
  Доступный в OS X v10.0 и позже.
- bSupports2TBFiles
  
  bSupports2TBFiles
  
  Объем поддерживает файлы на 2 терабайта.
  
  Доступный в OS X v10.0 и позже.
- bSupportsLongNames
  
  bSupportsLongNames
  
  Объем поддерживает файл, каталог и имена томов дольше, чем 31 символ.
  
  Доступный в OS X v10.0 и позже.
- bSupportsMultiScriptNames
  
  bSupportsMultiScriptNames
  
  Объем поддерживает файл, каталог и имена томов с символами от многократных систем сценария.
  
  Доступный в OS X v10.0 и позже.
- bSupportsNamedForks
  
  bSupportsNamedForks
  
  Объем поддерживает именованные ветвления кроме ветвей данных и ветвей ресурсов.
  
  Доступный в OS X v10.0 и позже.
- bSupportsSubtreeIterators
  
  bSupportsSubtreeIterators
  
  Объем поддерживает рекурсивные итераторы, не в корне объема.
  
  Доступный в OS X v10.0 и позже.
- bL2PCanMapFileBlocks
  
  bL2PCanMapFileBlocks
  
  Объем поддерживает Lg2Phys SPI правильно.
  
  Доступный в OS X v10.0 и позже.
- bParentModDateChanges
  
  bParentModDateChanges
  
  На этом объеме, изменяя файл или папку заставляет дату модификации ее родителя изменяться.
  
  Доступный в OS X v10.0 и позже.
- bAncestorModDateChanges
  
  bAncestorModDateChanges
  
  На этом объеме, изменяя файл или папку заставляет все даты модификации наследователя изменяться.
  
  Доступный в OS X v10.0 и позже.
- bSupportsSymbolicLinks
  
  bSupportsSymbolicLinks
  
  Объем поддерживает создание и использование символьных ссылок (только OS X).
  
  Доступный в OS X v10.0 и позже.
- bIsAutoMounted
  
  bIsAutoMounted
  
  Объем был смонтирован автоматически (только OS X).
  
  Доступный в OS X v10.0 и позже.
- bAllowCDiDataHandler
  
  bAllowCDiDataHandler
  
  Обработчику данных CDi QuickTime позволяют исследовать объем.
  
  Доступный в OS X v10.1 и позже.
- bSupportsExclusiveLocks
  
  bSupportsExclusiveLocks
  
  Объем поддерживает эксклюзивный доступ к файлам, открытым для записи.
  
  Доступный в OS X v10.2 и позже.
- bSupportsJournaling
  
  bSupportsJournaling
  
  Объем поддерживает журналирование. Это не указывает, включается ли журналирование в настоящее время на объеме.
  
  Доступный в OS X v10.3 и позже.
- bNoVolumeSizes
  
  bNoVolumeSizes
  
  Объем неспособен сообщить о размере тома или свободном пространстве.
  
  Доступный в OS X v10.3 и позже.
- bIsOnInternalBus
  
  bIsOnInternalBus
  
  Устройство находится на внутренней шине. Посмотрите примечание ниже.
  
  Доступный в OS X v10.4 и позже.
- bIsCaseSensitive
  
  bIsCaseSensitive
  
  Объем чувствителен к регистру.
  
  Доступный в OS X v10.3 и позже.
- bIsCasePreserving
  
  bIsCasePreserving
  
  Объем является случаем заповедников.
  
  Доступный в OS X v10.3 и позже.
- bDoNotDisplay
  
  bDoNotDisplay
  
  Объем не должен быть выведен на экран в пользовательском интерфейсе.
  
  Доступный в OS X v10.3 и позже.
- bIsRemovable
  
  bIsRemovable
  
  Устройство является съемным согласно IOKit.
  
  Доступный в OS X v10.4 и позже.
- bNoRootTimes
  
  bNoRootTimes
  
  Объем не устанавливает надежные времена для своего корневого каталога.
  
  Доступный в OS X v10.4 и позже.
- bIsOnExternalBus
  
  bIsOnExternalBus
  
  Устройство находится на внешней шине. Посмотрите примечание ниже.
  
  Доступный в OS X v10.4 и позже.
- bSupportsExtendedFileSecurity
  
  bSupportsExtendedFileSecurity
  
  Объем поддерживает объекты FSFileSecurity.
  
  Доступный в OS X v10.4 и позже.
Обсуждение

GetVolParmsInfoBuffer структура использует эти константы в vMExtendedAttributes поле.

Примечание:

Объем может возвратить одно из четырех состояний через bIsOnInternalBus и bIsOnExternalBus биты. Объем, который, как известно, был на внутренней шине, установит bIsOnInternalBus и ясный bIsOnExternalBus. Объем, который, как известно, был на внешней шине, очистится bIsOnInternalBus и набор bIsOnExternalBus. Объем на шине, которая неопределенна (мог быть любой) установит оба бита. Объем не на локальной шине, такой как сетевой том, оставит оба бита ясными.
Флаги FCB
Укажите флаги, описывающие состояние файла.

Объявление

Swift

var kioFCBWriteBit: Int { get } var kioFCBWriteMask: Int { get } var kioFCBResourceBit: Int { get } var kioFCBResourceMask: Int { get } var kioFCBWriteLockedBit: Int { get } var kioFCBWriteLockedMask: Int { get } var kioFCBLargeFileBit: Int { get } var kioFCBLargeFileMask: Int { get } var kioFCBSharedWriteBit: Int { get } var kioFCBSharedWriteMask: Int { get } var kioFCBFileLockedBit: Int { get } var kioFCBFileLockedMask: Int { get } var kioFCBOwnClumpBit: Int { get } var kioFCBOwnClumpMask: Int { get } var kioFCBModifiedBit: Int { get } var kioFCBModifiedMask: Int { get }

Objective C

enum { kioFCBWriteBit = 8, kioFCBWriteMask = 0x0100, kioFCBResourceBit = 9, kioFCBResourceMask = 0x0200, kioFCBWriteLockedBit = 10, kioFCBWriteLockedMask = 0x0400, kioFCBLargeFileBit = 11, kioFCBLargeFileMask = 0x0800, kioFCBSharedWriteBit = 12, kioFCBSharedWriteMask = 0x1000, kioFCBFileLockedBit = 13, kioFCBFileLockedMask = 0x2000, kioFCBOwnClumpBit = 14, kioFCBOwnClumpMask = 0x4000, kioFCBModifiedBit = 15, kioFCBModifiedMask = 0x8000 };

Константы
- kioFCBWriteBit
  
  kioFCBWriteBit
  
  Набор, если данные могут быть записаны в этот файл.
  
  Доступный в OS X v10.0 и позже.
- kioFCBWriteMask
  
  kioFCBWriteMask
  
  Тесты, если данные могут быть записаны в этот файл.
  
  Доступный в OS X v10.0 и позже.
- kioFCBResourceBit
  
  kioFCBResourceBit
  
  Набор, если этот FCB описывает ветвь ресурсов.
  
  Доступный в OS X v10.0 и позже.
- kioFCBResourceMask
  
  kioFCBResourceMask
  
  Тесты, если этот FCB описывает ветвь ресурсов.
  
  Доступный в OS X v10.0 и позже.
- kioFCBWriteLockedBit
  
  kioFCBWriteLockedBit
  
  Набор, если этот файл имеет заблокированный диапазон байта.
  
  Доступный в OS X v10.0 и позже.
- kioFCBWriteLockedMask
  
  kioFCBWriteLockedMask
  
  Тесты, если этот файл имеет заблокированный диапазон байта.
  
  Доступный в OS X v10.0 и позже.
- kioFCBLargeFileBit
  
  kioFCBLargeFileBit
  
  Набор, если этот файл может расти вне 2 ГБ и кэш, использует блоки файла, не байты.
  
  Доступный в OS X v10.0 и позже.
- kioFCBLargeFileMask
  
  kioFCBLargeFileMask
  
  Тесты, если этот файл может расти вне 2 ГБ и кэш, используют блоки файла, не байты.
  
  Доступный в OS X v10.0 и позже.
- kioFCBSharedWriteBit
  
  kioFCBSharedWriteBit
  
  Набор, если этот файл совместно использовал полномочия записи.
  
  Доступный в OS X v10.0 и позже.
- kioFCBSharedWriteMask
  
  kioFCBSharedWriteMask
  
  Тесты, если этот файл совместно использовал полномочия записи.
  
  Доступный в OS X v10.0 и позже.
- kioFCBFileLockedBit
  
  kioFCBFileLockedBit
  
  Набор, если этот файл заблокирован (защищенный от записи).
  
  Доступный в OS X v10.0 и позже.
- kioFCBFileLockedMask
  
  kioFCBFileLockedMask
  
  Тесты, если этот файл заблокирован (защищенный от записи).
  
  Доступный в OS X v10.0 и позже.
- kioFCBOwnClumpBit
  
  kioFCBOwnClumpBit
  
  Набор, если размер глыбы этого файла указан в FCB.
  
  Доступный в OS X v10.0 и позже.
- kioFCBOwnClumpMask
  
  kioFCBOwnClumpMask
  
  Тесты, если размер глыбы этого файла указан в FCB.
  
  Доступный в OS X v10.0 и позже.
- kioFCBModifiedBit
  
  kioFCBModifiedBit
  
  Набор, если этот файл изменился, так как это было в последний раз сброшено.
  
  Доступный в OS X v10.0 и позже.
- kioFCBModifiedMask
  
  kioFCBModifiedMask
  
  Тесты, если этот файл изменился, так как он был в последний раз сброшен.
  
  Доступный в OS X v10.0 и позже.
Обсуждение

Эти константы используются в ioFCBFlags поле FCBPBRec возвращенный функциями PBGetFCBInfoSync и PBGetFCBInfoAsync .
Константы разрешения доступа к файлу
Укажите тип доступа для чтения и доступа для записи к файлу или ветвления.

Объявление

Swift

var fsCurPerm: Int { get } var fsRdPerm: Int { get } var fsWrPerm: Int { get } var fsRdWrPerm: Int { get } var fsRdWrShPerm: Int { get } var fsRdDenyPerm: Int { get } var fsWrDenyPerm: Int { get }

Objective C

enum { fsCurPerm = 0x00, fsRdPerm = 0x01, fsWrPerm = 0x02, fsRdWrPerm = 0x03, fsRdWrShPerm = 0x04, fsRdDenyPerm = 0x10, fsWrDenyPerm = 0x20 };

Константы
- fsCurPerm
  
  fsCurPerm
  
  Запросы безотносительно полномочий в настоящее время позволяются. Если доступ для записи в недоступном (потому что файл заблокирован или файл уже открыт с разрешением записи), то считанное разрешение дано. Иначе разрешение чтения-записи дано.
  
  Доступный в OS X v10.0 и позже.
- fsRdPerm
  
  fsRdPerm
  
  Разрешение запросов считать файл.
  
  Доступный в OS X v10.0 и позже.
- fsWrPerm
  
  fsWrPerm
  
  Разрешение запросов записать в файл. Если разрешение записи дано, никакие другие пути доступа не даны разрешение записи. Отметьте, однако, что Файловый менеджер не поддерживает доступ только для записи к файлу. Таким образом, fsWrPerm синонимично с fsRdWrPerm.
  
  Доступный в OS X v10.0 и позже.
- fsRdWrPerm
  
  fsRdWrPerm
  
  Запрашивает монопольное чтение и разрешение записи. Если монопольное чтение / разрешение записи предоставляют, никакие другие пользователи не являются данным разрешением для записи в файл. Другие пользователи могут, однако, быть данным разрешением для чтения файла.
  
  Доступный в OS X v10.0 и позже.
- fsRdWrShPerm
  
  fsRdWrShPerm
  
  Запросы совместно использовали разрешение записи и чтение. Совместно использованное разрешение чтения и записи позволяет пути множественного доступа для чтения и записи. Это безопасно, только если существует некоторый способ заблокировать части файла прежде, чем записать в них. На объемах, поддерживающих блокировку диапазона, можно использовать функции PBLockRangeSync и PBUnlockRangeSync заблокировать и разблокировать диапазоны байтов в файле. Приложения, работающие в версии 10.4 OS X или позже, должны использовать функции FSLockRange и FSUnlockRange с этой целью.
  
  Доступный в OS X v10.0 и позже.
- fsRdDenyPerm
  
  fsRdDenyPerm
  
  Запросы, что любые другие пути препятствоваться иметь доступ для чтения. Путь не может быть открыт, если Вы запрашиваете разрешение чтения (с fsRdPerm постоянный), но некоторый другой путь запросил отклонять-доступ-для-чтения. Точно так же путь не может быть открыт, если Вы запрашиваете разрешение отклонять-чтения, но некоторый другой путь уже имеет доступ для чтения. Эта константа только поддерживается на объемах, возвращающихся bHasOpenDeny припишите, когда Вы вызовете FSGetVolumeParms.
  
  Доступный в OS X v10.0 и позже.
- fsWrDenyPerm
  
  fsWrDenyPerm
  
  Запросы, что любые другие пути препятствоваться иметь доступ для записи. Путь не может быть открыт, если Вы запрашиваете разрешение записи (с fsWrPerm постоянный), но некоторый другой путь запросил отклонять-доступ-для-записи. Точно так же путь не может быть открыт, если Вы запрашиваете разрешение отклонять-записи, но некоторый другой путь уже имеет доступ для записи. Эта константа только поддерживается на объемах, возвращающихся bHasOpenDeny припишите, когда Вы вызовете FSGetVolumeParms.
  
  Доступный в OS X v10.0 и позже.
Обсуждение

Используйте эти константы, чтобы запросить тип доступа к файлу или ветвлению, или отклонить тип доступа к файлу или ветвления к другим путям, которые могут запросить доступ.

Обратите внимание на то, что это возможно, в Mac OS 8 и 9, для открытия файла, находящегося на носителях только для чтения с доступом для записи. В OS X, однако, Вы не можете открыть файл с доступом для записи на носителях только для чтения; попытка открыть сбои файла с a wrPermErr ошибка.
Файл и константы права доступа папки
Укажите права доступа для файлов и каталогов в ioACAccess поле AccessParam тип данных.

Объявление

Swift

var kioACAccessOwnerBit: Int { get } var kioACAccessOwnerMask: Int { get } var kioACAccessBlankAccessBit: Int { get } var kioACAccessBlankAccessMask: Int { get } var kioACAccessUserWriteBit: Int { get } var kioACAccessUserWriteMask: Int { get } var kioACAccessUserReadBit: Int { get } var kioACAccessUserReadMask: Int { get } var kioACAccessUserSearchBit: Int { get } var kioACAccessUserSearchMask: Int { get } var kioACAccessEveryoneWriteBit: Int { get } var kioACAccessEveryoneWriteMask: Int { get } var kioACAccessEveryoneReadBit: Int { get } var kioACAccessEveryoneReadMask: Int { get } var kioACAccessEveryoneSearchBit: Int { get } var kioACAccessEveryoneSearchMask: Int { get } var kioACAccessGroupWriteBit: Int { get } var kioACAccessGroupWriteMask: Int { get } var kioACAccessGroupReadBit: Int { get } var kioACAccessGroupReadMask: Int { get } var kioACAccessGroupSearchBit: Int { get } var kioACAccessGroupSearchMask: Int { get } var kioACAccessOwnerWriteBit: Int { get } var kioACAccessOwnerWriteMask: Int { get } var kioACAccessOwnerReadBit: Int { get } var kioACAccessOwnerReadMask: Int { get } var kioACAccessOwnerSearchBit: Int { get } var kioACAccessOwnerSearchMask: Int { get } var kfullPrivileges: Int { get } var kownerPrivileges: Int { get }

Objective C

enum { kioACAccessOwnerBit = 31, kioACAccessOwnerMask = 0x80000000, kioACAccessBlankAccessBit = 28, kioACAccessBlankAccessMask = 0x10000000, kioACAccessUserWriteBit = 26, kioACAccessUserWriteMask = 0x04000000, kioACAccessUserReadBit = 25, kioACAccessUserReadMask = 0x02000000, kioACAccessUserSearchBit = 24, kioACAccessUserSearchMask = 0x01000000, kioACAccessEveryoneWriteBit = 18, kioACAccessEveryoneWriteMask = 0x00040000, kioACAccessEveryoneReadBit = 17, kioACAccessEveryoneReadMask = 0x00020000, kioACAccessEveryoneSearchBit = 16, kioACAccessEveryoneSearchMask = 0x00010000, kioACAccessGroupWriteBit = 10, kioACAccessGroupWriteMask = 0x00000400, kioACAccessGroupReadBit = 9, kioACAccessGroupReadMask = 0x00000200, kioACAccessGroupSearchBit = 8, kioACAccessGroupSearchMask = 0x00000100, kioACAccessOwnerWriteBit = 2, kioACAccessOwnerWriteMask = 0x00000004, kioACAccessOwnerReadBit = 1, kioACAccessOwnerReadMask = 0x00000002, kioACAccessOwnerSearchBit = 0, kioACAccessOwnerSearchMask = 0x00000001, kfullPrivileges = 0x00070007, kownerPrivileges = 0x00000007 };

Константы
- kioACAccessOwnerBit
  
  kioACAccessOwnerBit
  
  Указывает, что пользователь является владельцем каталога.
  
  Доступный в OS X v10.0 и позже.
- kioACAccessOwnerMask
  
  kioACAccessOwnerMask
  
  Пользователь является владельцем каталога.
  
  Доступный в OS X v10.0 и позже.
- kioACAccessBlankAccessBit
  
  kioACAccessBlankAccessBit
  
  Указывает, что каталог имеет пустые права доступа.
  
  Доступный в OS X v10.0 и позже.
- kioACAccessBlankAccessMask
  
  kioACAccessBlankAccessMask
  
  Каталог имеет пустые права доступа. Каталог с пустым набором прав доступа игнорирует другие биты права доступа и использует биты права доступа его родительского каталога.
  
  Доступный в OS X v10.0 и позже.
- kioACAccessUserWriteBit
  
  kioACAccessUserWriteBit
  
  Указывает, что у пользователя есть полномочия записи.
  
  Доступный в OS X v10.0 и позже.
- kioACAccessUserWriteMask
  
  kioACAccessUserWriteMask
  
  У пользователя есть полномочия записи.
  
  Доступный в OS X v10.0 и позже.
- kioACAccessUserReadBit
  
  kioACAccessUserReadBit
  
  Указывает, что пользователь считал полномочия.
  
  Доступный в OS X v10.0 и позже.
- kioACAccessUserReadMask
  
  kioACAccessUserReadMask
  
  Пользователь считал полномочия.
  
  Доступный в OS X v10.0 и позже.
- kioACAccessUserSearchBit
  
  kioACAccessUserSearchBit
  
  Указывает, что у пользователя есть поисковые полномочия.
  
  Доступный в OS X v10.0 и позже.
- kioACAccessUserSearchMask
  
  kioACAccessUserSearchMask
  
  У пользователя есть поисковые полномочия.
  
  Доступный в OS X v10.0 и позже.
- kioACAccessEveryoneWriteBit
  
  kioACAccessEveryoneWriteBit
  
  Указывает, что у всех есть полномочия записи.
  
  Доступный в OS X v10.0 и позже.
- kioACAccessEveryoneWriteMask
  
  kioACAccessEveryoneWriteMask
  
  У всех есть полномочия записи.
  
  Доступный в OS X v10.0 и позже.
- kioACAccessEveryoneReadBit
  
  kioACAccessEveryoneReadBit
  
  Указывает, что все считали полномочия.
  
  Доступный в OS X v10.0 и позже.
- kioACAccessEveryoneReadMask
  
  kioACAccessEveryoneReadMask
  
  Все считали полномочия.
  
  Доступный в OS X v10.0 и позже.
- kioACAccessEveryoneSearchBit
  
  kioACAccessEveryoneSearchBit
  
  Указывает, что у всех есть поисковые полномочия.
  
  Доступный в OS X v10.0 и позже.
- kioACAccessEveryoneSearchMask
  
  kioACAccessEveryoneSearchMask
  
  У всех есть поисковые полномочия.
  
  Доступный в OS X v10.0 и позже.
- kioACAccessGroupWriteBit
  
  kioACAccessGroupWriteBit
  
  Указывает, что у группы есть полномочия записи.
  
  Доступный в OS X v10.0 и позже.
- kioACAccessGroupWriteMask
  
  kioACAccessGroupWriteMask
  
  У группы есть полномочия записи.
  
  Доступный в OS X v10.0 и позже.
- kioACAccessGroupReadBit
  
  kioACAccessGroupReadBit
  
  Указывает, что группа считала полномочия.
  
  Доступный в OS X v10.0 и позже.
- kioACAccessGroupReadMask
  
  kioACAccessGroupReadMask
  
  Группа считала полномочия.
  
  Доступный в OS X v10.0 и позже.
- kioACAccessGroupSearchBit
  
  kioACAccessGroupSearchBit
  
  Указывает, что у группы есть поисковые полномочия.
  
  Доступный в OS X v10.0 и позже.
- kioACAccessGroupSearchMask
  
  kioACAccessGroupSearchMask
  
  У группы есть поисковые полномочия.
  
  Доступный в OS X v10.0 и позже.
- kioACAccessOwnerWriteBit
  
  kioACAccessOwnerWriteBit
  
  Указывает, что у владельца есть полномочия записи.
  
  Доступный в OS X v10.0 и позже.
- kioACAccessOwnerWriteMask
  
  kioACAccessOwnerWriteMask
  
  У владельца есть полномочия записи.
  
  Доступный в OS X v10.0 и позже.
- kioACAccessOwnerReadBit
  
  kioACAccessOwnerReadBit
  
  Указывает, что владелец считал полномочия.
  
  Доступный в OS X v10.0 и позже.
- kioACAccessOwnerReadMask
  
  kioACAccessOwnerReadMask
  
  Владелец считал полномочия.
  
  Доступный в OS X v10.0 и позже.
- kioACAccessOwnerSearchBit
  
  kioACAccessOwnerSearchBit
  
  Указывает, что у владельца есть поисковые полномочия.
  
  Доступный в OS X v10.0 и позже.
- kioACAccessOwnerSearchMask
  
  kioACAccessOwnerSearchMask
  
  У владельца есть поисковые полномочия.
  
  Доступный в OS X v10.0 и позже.
- kfullPrivileges
  
  kfullPrivileges
  
  Указывает, что у всех, включая владельца, есть все полномочия.
  
  Доступный в OS X v10.0 и позже.
- kownerPrivileges
  
  kownerPrivileges
  
  Указывает, что только у владельца есть все полномочия.
  
  Доступный в OS X v10.0 и позже.
Обсуждение

Посмотрите AccessParam.
Константы атрибута файла
Определите файл и атрибуты каталога, возвращенные PBGetCatInfoSync и PBGetCatInfoAsync функции.

Объявление

Swift

var kioFlAttribLockedBit: Int { get } var kioFlAttribLockedMask: Int { get } var kioFlAttribResOpenBit: Int { get } var kioFlAttribResOpenMask: Int { get } var kioFlAttribDataOpenBit: Int { get } var kioFlAttribDataOpenMask: Int { get } var kioFlAttribDirBit: Int { get } var kioFlAttribDirMask: Int { get } var ioDirFlg: Int { get } var ioDirMask: Int { get } var kioFlAttribCopyProtBit: Int { get } var kioFlAttribCopyProtMask: Int { get } var kioFlAttribFileOpenBit: Int { get } var kioFlAttribFileOpenMask: Int { get } var kioFlAttribInSharedBit: Int { get } var kioFlAttribInSharedMask: Int { get } var kioFlAttribMountedBit: Int { get } var kioFlAttribMountedMask: Int { get } var kioFlAttribSharePointBit: Int { get } var kioFlAttribSharePointMask: Int { get }

Objective C

enum { kioFlAttribLockedBit = 0, kioFlAttribLockedMask = 0x01, kioFlAttribResOpenBit = 2, kioFlAttribResOpenMask = 0x04, kioFlAttribDataOpenBit = 3, kioFlAttribDataOpenMask = 0x08, kioFlAttribDirBit = 4, kioFlAttribDirMask = 0x10, ioDirFlg = 4, ioDirMask = 0x10, kioFlAttribCopyProtBit = 6, kioFlAttribCopyProtMask = 0x40, kioFlAttribFileOpenBit = 7, kioFlAttribFileOpenMask = 0x80, kioFlAttribInSharedBit = 2, kioFlAttribInSharedMask = 0x04, kioFlAttribMountedBit = 3, kioFlAttribMountedMask = 0x08, kioFlAttribSharePointBit = 5, kioFlAttribSharePointMask = 0x20 };

Константы
- kioFlAttribLockedBit
  
  kioFlAttribLockedBit
  
  Указывает, что заблокирован файл или каталог. Используйте функции PBHSetFLockSync и PBHSetFLockAsync заблокировать файл или каталог. Используйте функции PBHRstFLockSync и PBHRstFLockAsync разблокировать файл или каталог.
  
  Доступный в OS X v10.0 и позже.
- kioFlAttribLockedMask
  
  kioFlAttribLockedMask
  
  Тесты, если заблокирован файл или каталог.
  
  Доступный в OS X v10.0 и позже.
- kioFlAttribResOpenBit
  
  kioFlAttribResOpenBit
  
  Указывает, что ветвь ресурсов открыта. Если ветвь ресурсов файла была открыта процессом кроме процесса, сделавшего звонок к, на OS X не установлен этот бит PBHGetCatInfo или PBHGetFInfo.
  
  Доступный в OS X v10.0 и позже.
- kioFlAttribResOpenMask
  
  kioFlAttribResOpenMask
  
  Тесты, если ветвь ресурсов открыта.
  
  Доступный в OS X v10.0 и позже.
- kioFlAttribDataOpenBit
  
  kioFlAttribDataOpenBit
  
  Указывает, что ветвь данных открыта. Если ветвь данных файла была открыта процессом кроме процесса, сделавшего звонок к, на OS X не установлен этот бит PBHGetCatInfo или PBHGetFInfo.
  
  Доступный в OS X v10.0 и позже.
- kioFlAttribDataOpenMask
  
  kioFlAttribDataOpenMask
  
  Тесты, если ветвь данных открыта.
  
  Доступный в OS X v10.0 и позже.
- kioFlAttribDirBit
  
  kioFlAttribDirBit
  
  Указывает, что это - каталог, не файл. Этот бит всегда ясен для файлов и всегда устанавливается для каталогов.
  
  Доступный в OS X v10.0 и позже.
- kioFlAttribDirMask
  
  kioFlAttribDirMask
  
  Тесты, если это - каталог.
  
  Доступный в OS X v10.0 и позже.
- ioDirFlg
  
  ioDirFlg
  
  Указывает, что это - каталог; это - старое название kioFlAttribDirBit.
  
  Доступный в OS X v10.0 и позже.
- ioDirMask
  
  ioDirMask
  
  Тесты, если это - каталог; это - старое название kioFlAttribDirMask.
  
  Доступный в OS X v10.0 и позже.
- kioFlAttribCopyProtBit
  
  kioFlAttribCopyProtBit
  
  Указывает, что файл «защищен от копирования» сервером AppleShare.
  
  Доступный в OS X v10.0 и позже.
- kioFlAttribCopyProtMask
  
  kioFlAttribCopyProtMask
  
  Тесты, если файл «защищен от копирования» сервером AppleShare.
  
  Доступный в OS X v10.0 и позже.
- kioFlAttribFileOpenBit
  
  kioFlAttribFileOpenBit
  
  Указывает, что файл открыт. Если или данные или ветвь ресурсов открыты, этот бит установлен. Если файл был открыт процессом кроме процесса, сделавшего звонок к, на OS X не установлен этот бит PBHGetCatInfo или PBHGetFInfo.
  
  Доступный в OS X v10.0 и позже.
- kioFlAttribFileOpenMask
  
  kioFlAttribFileOpenMask
  
  Тесты, если файл открыт. Если или данные или ветвь ресурсов открыты, файл открыт.
  
  Доступный в OS X v10.0 и позже.
- kioFlAttribInSharedBit
  
  kioFlAttribInSharedBit
  
  Указывает, что каталог в совместно используемой области иерархии каталогов.
  
  Доступный в OS X v10.0 и позже.
- kioFlAttribInSharedMask
  
  kioFlAttribInSharedMask
  
  Тесты, если каталог в совместно используемой области иерархии каталогов.
  
  Доступный в OS X v10.0 и позже.
- kioFlAttribMountedBit
  
  kioFlAttribMountedBit
  
  Указывает, что каталог является точкой доли, смонтированной пользователем.
  
  Доступный в OS X v10.0 и позже.
- kioFlAttribMountedMask
  
  kioFlAttribMountedMask
  
  Тесты, если каталог является точкой доли, смонтированной пользователем.
  
  Доступный в OS X v10.0 и позже.
- kioFlAttribSharePointBit
  
  kioFlAttribSharePointBit
  
  Указывает, что каталог является точкой доли.
  
  Доступный в OS X v10.0 и позже.
- kioFlAttribSharePointMask
  
  kioFlAttribSharePointMask
  
  Тесты, если каталог является точкой доли.
  
  Доступный в OS X v10.0 и позже.
Обсуждение

Эти константы используются в ioFlAttrib поля HFileInfo и DirInfo структуры, возвращенные функциями PBGetCatInfoSync и PBGetCatInfoAsync .
Опции работы файла
Флаги, которые можно использовать, чтобы указать, как выполнить работу файла.

Объявление

Swift

var kFSFileOperationDefaultOptions: Int { get } var kFSFileOperationOverwrite: Int { get } var kFSFileOperationSkipSourcePermissionErrors: Int { get } var kFSFileOperationDoNotMoveAcrossVolumes: Int { get } var kFSFileOperationSkipPreflight: Int { get }

Objective C

enum { kFSFileOperationDefaultOptions = 0, kFSFileOperationOverwrite = 0x01, kFSFileOperationSkipSourcePermissionErrors = 0x02, kFSFileOperationDoNotMoveAcrossVolumes = 0x04, kFSFileOperationSkipPreflight = 0x08 };

Константы
- kFSFileOperationDefaultOptions
  
  kFSFileOperationDefaultOptions
  Используйте следующие опции по умолчанию:
  
  Если целевой каталог содержит объект с тем же именем как исходный объект, прервите работу.
  
  Если исходный объект не может быть считан, прервать работу.
  
  Если спросили переместить объект через границы объема, выполните работу.
  Доступный в OS X v10.4 и позже.
- kFSFileOperationOverwrite
  
  kFSFileOperationOverwrite
  
  Если целевой каталог содержит объект с тем же именем как исходный объект, перезапишите целевой объект.
  
  Доступный в OS X v10.4 и позже.
- kFSFileOperationSkipSourcePermissionErrors
  
  kFSFileOperationSkipSourcePermissionErrors
  
  Если исходный объект не может быть считан, пропустите объект и продолжайте работу.
  
  Доступный в OS X v10.4 и позже.
- kFSFileOperationDoNotMoveAcrossVolumes
  
  kFSFileOperationDoNotMoveAcrossVolumes
  
  Если спросили переместить объект через границы объема, прервите работу.
  
  Доступный в OS X v10.4 и позже.
- kFSFileOperationSkipPreflight
  
  kFSFileOperationSkipPreflight
  
  Пропустите этап перед рейсом для перемещения каталога или скопируйте работу. Эта опция ограничивает информацию о статусе, которая может быть возвращена во время работы.
  
  Доступный в OS X v10.4 и позже.
Обсуждение

Эти флаги могут быть переданы любой из функций, инициирующих работу файла. Для получения дополнительной информации посмотрите Копирование и Перемещение Объектов Используя Асинхронные Высокоуровневые Операции Файла.
Этапы работы файла
Константы, используемые Файловым менеджером для указания текущего этапа асинхронной работы файла.

Объявление

Swift

typealias FSFileOperationStage = UInt32

Objective C

typedef UInt32 FSFileOperationStage; enum { kFSOperationStageUndefined = 0, kFSOperationStagePreflighting = 1, kFSOperationStageRunning = 2, kFSOperationStageComplete = 3 };

Константы
- kFSOperationStageUndefined
  
  kFSOperationStageUndefined
  
  Файловый менеджер не запустил работу файла.
  
  Доступный в OS X v10.4 и позже.
- kFSOperationStagePreflighting
  
  kFSOperationStagePreflighting
  
  Файловый менеджер выполняет задачи, такие как вычисление размеров и числа объектов в работе и проверки, чтобы удостовериться, что существует достаточно пространства на целевом объеме для завершения работы.
  
  Доступный в OS X v10.4 и позже.
- kFSOperationStageRunning
  
  kFSOperationStageRunning
  
  Файловый менеджер копирует или перемещает файл или каталог.
  
  Доступный в OS X v10.4 и позже.
- kFSOperationStageComplete
  
  kFSOperationStageComplete
  
  Работа файла завершена.
  
  Доступный в OS X v10.4 и позже.
Обсуждение

Эти константы пасуются назад к Вашей функции обратного вызова состояния работы файла. Для получения дополнительной информации посмотрите Обратные вызовы Работы Файла. Можно также получить текущий этап работы файла путем вызывания функции средства доступа состояния такой как FSFileOperationCopyStatus.

Оператор импорта

Objective C

@import CoreServices;

Swift

import CoreServices

Доступность

Доступный в OS X v10.4 и позже.
Ключи словаря состояния работы файла
Ключи раньше определяли состояние работы файла, как сообщается в словаре состояния.

Объявление

Objective C

const CFStringRef kFSOperationTotalBytesKey; const CFStringRef kFSOperationBytesCompleteKey; const CFStringRef kFSOperationBytesRemainingKey; const CFStringRef kFSOperationTotalObjectsKey; const CFStringRef kFSOperationObjectsCompleteKey; const CFStringRef kFSOperationObjectsRemainingKey; const CFStringRef kFSOperationTotalUserVisibleObjectsKey; const CFStringRef kFSOperationUserVisibleObjectsCompleteKey; const CFStringRef kFSOperationUserVisibleObjectsRemainingKey; const CFStringRef kFSOperationThroughputKey;

Константы
- kFSOperationTotalBytesKey
  
  kFSOperationTotalBytesKey
  
  Значение для этого ключа является CFNumber, представляющим общее количество байтов, которые будут перемещены или скопированы этой работой файла. Это значение не доступно для работы каталога если kFSFileOperationSkipPreflight флаг опции указан.
  
  Доступный в OS X v10.4 и позже.
  Осуждаемый в OS X v10.8.
- kFSOperationBytesCompleteKey
  
  kFSOperationBytesCompleteKey
  
  Значение для этого ключа является CFNumber, представляющим общее количество байтов, уже перемещенных или скопированных этой работой файла.
  
  Доступный в OS X v10.4 и позже.
  Осуждаемый в OS X v10.8.
- kFSOperationBytesRemainingKey
  
  kFSOperationBytesRemainingKey
  
  Значение для этого ключа является CFNumber, представляющим общее количество байтов, остающихся быть перемещенными или скопированными этой работой файла.
  
  Доступный в OS X v10.4 и позже.
  Осуждаемый в OS X v10.8.
- kFSOperationTotalObjectsKey
  
  kFSOperationTotalObjectsKey
  
  Значение для этого ключа является CFNumber, представляющим общее количество объектов, которые будут перемещены или скопированы этой работой файла.
  
  Доступный в OS X v10.4 и позже.
  Осуждаемый в OS X v10.8.
- kFSOperationObjectsCompleteKey
  
  kFSOperationObjectsCompleteKey
  
  Значение для этого ключа является CFNumber, представляющим общее количество объектов, уже перемещенных или скопированных этой работой файла.
  
  Доступный в OS X v10.4 и позже.
  Осуждаемый в OS X v10.8.
- kFSOperationObjectsRemainingKey
  
  kFSOperationObjectsRemainingKey
  
  Значение для этого ключа является CFNumber, представляющим общее количество объектов, остающихся быть перемещенными или скопированными этой работой файла.
  
  Доступный в OS X v10.4 и позже.
  Осуждаемый в OS X v10.8.
- kFSOperationTotalUserVisibleObjectsKey
  
  kFSOperationTotalUserVisibleObjectsKey
  
  Значение для этого ключа является CFNumber, представляющим общее количество пользовательских видимых объектов, которые будут перемещены или скопированы этой работой файла. В целом объект видим пользователем, если он выведен на экран в окне Finder. Например, пакет считается как видимый объект отдельного пользователя даже при том, что он обычно содержит много других объектов.
  
  Доступный в OS X v10.4 и позже.
  Осуждаемый в OS X v10.8.
- kFSOperationUserVisibleObjectsCompleteKey
  
  kFSOperationUserVisibleObjectsCompleteKey
  
  Значение для этого ключа является CFNumber, представляющим общее количество пользовательских видимых объектов, уже перемещенных или скопированных этой работой файла.
  
  Доступный в OS X v10.4 и позже.
  Осуждаемый в OS X v10.8.
- kFSOperationUserVisibleObjectsRemainingKey
  
  kFSOperationUserVisibleObjectsRemainingKey
  
  Значение для этого ключа является CFNumber, представляющим общее количество пользовательских видимых объектов, остающихся быть перемещенными или скопированными этой работой файла.
  
  Доступный в OS X v10.4 и позже.
  Осуждаемый в OS X v10.8.
- kFSOperationThroughputKey
  
  kFSOperationThroughputKey
  
  Значение для этого ключа является CFNumber, представляющим текущую пропускную способность этой работы файла в байтах в секунду.
  
  Доступный в OS X v10.4 и позже.
  Осуждаемый в OS X v10.8.
Обсуждение

Словарь состояния для работы файла пасуется назад к Вашей функции обратного вызова состояния. Для получения дополнительной информации посмотрите Обратные вызовы Работы Файла. Можно также получить словарь состояния для работы файла путем вызывания функции средства доступа состояния такой как FSFileOperationCopyStatus.
FNMessage
Объявление

Swift

typealias FNMessage = UInt32

Objective C

typedef UInt32 FNMessage; enum { kFNDirectoryModifiedMessage = 1 };

Константы
- kFNDirectoryModifiedMessage
  
  kFNDirectoryModifiedMessage
  
  Доступный в OS X v10.0 и позже.
Оператор импорта

Objective C

@import CoreServices;

Swift

import CoreServices

Доступность

Доступный в OS X v10.0 и позже.
Внешняя постоянная модель полномочия
Идентифицирует модель полномочия A/UX.

Объявление

Swift

var fsUnixPriv: Int { get }

Objective C

enum { fsUnixPriv = 1 };

Константы
- fsUnixPriv
  
  fsUnixPriv
  
  Представляет объем, поддерживающий модель полномочия A/UX.
  
  Доступный в OS X v10.0 и позже.
Обсуждение

Используемый в vMForeignPrivID поле GetVolParmsInfoBuffer.
Группа постоянный ID
Объявление

Swift

var knoGroup: Int { get }

Objective C

enum { knoGroup = 0 };

Константы
- knoGroup
  
  knoGroup
  
  Доступный в OS X v10.0 и позже.
Константы размера значков
Укажите размеры настольных типов значков базы данных.

Объявление

Swift

var kLargeIconSize: Int { get } var kLarge4BitIconSize: Int { get } var kLarge8BitIconSize: Int { get } var kSmallIconSize: Int { get } var kSmall4BitIconSize: Int { get } var kSmall8BitIconSize: Int { get }

Objective C

enum { kLargeIconSize = 256, kLarge4BitIconSize = 512, kLarge8BitIconSize = 1024, kSmallIconSize = 64, kSmall4BitIconSize = 128, kSmall8BitIconSize = 256 };

Константы
- kLargeIconSize
  
  kLargeIconSize
  
  Большой черно-белый значок с маской. Соответствующий тип ресурса:'ICN#'.
  
  Доступный в OS X v10.0 и позже.
- kLarge4BitIconSize
  
  kLarge4BitIconSize
  
  Большой 4-разрядный цветной значок. Соответствующий тип ресурса:'icl4’.
  
  Доступный в OS X v10.0 и позже.
- kLarge8BitIconSize
  
  kLarge8BitIconSize
  
  Большой 8-разрядный цветной значок. Соответствующий тип ресурса:'icl8'.
  
  Доступный в OS X v10.0 и позже.
- kSmallIconSize
  
  kSmallIconSize
  
  Маленький черно-белый значок с маской. Соответствующий тип ресурса:'ics#'.
  
  Доступный в OS X v10.0 и позже.
- kSmall4BitIconSize
  
  kSmall4BitIconSize
  
  Маленький 4-разрядный цветной значок. Соответствующий тип ресурса:'ics4'.
  
  Доступный в OS X v10.0 и позже.
- kSmall8BitIconSize
  
  kSmall8BitIconSize
  
  Маленький 8-разрядный цветной значок. Соответствующий тип ресурса:'ics8'.
  
  Доступный в OS X v10.0 и позже.
Обсуждение

Эти константы указывают сумму хранения, которое необходимо выделить для данных значка для каждого из типов значков, указанных Константами Типа значков. Настольные функции базы данных, устанавливающие или получающие данные а именно, значка, PBDTAddIconSync , PBDTAddIconAsync , PBDTGetIconSync , PBDTGetIconAsync , PBDTGetIconInfoSync , и PBDTGetIconInfoAsync – ожидайте указатель на хранение в ioDTBuffer поле DTPBRec блок параметра и надлежащая константа в ioDTReqCount поле.
Константы типа значков
Укажите типы значков для настольной базы данных.

Объявление

Objective C

enum { kLargeIcon = 1, kLarge4BitIcon = 2, kLarge8BitIcon = 3, kSmallIcon = 4, kSmall4BitIcon = 5, kSmall8BitIcon = 6, kicnsIconFamily = 239 };

Константы
- kLargeIcon
  
  kLargeIcon
  
  Большой черно-белый значок с маской. Соответствующий тип ресурса:'ICN#'.
  
  Доступный в OS X v10.0 и позже.
  Не доступный 64-разрядным приложениям.
- kLarge4BitIcon
  
  kLarge4BitIcon
  
  Большой 4-разрядный цветной значок. Соответствующий тип ресурса:'icl4’.
  
  Доступный в OS X v10.0 и позже.
  Не доступный 64-разрядным приложениям.
- kLarge8BitIcon
  
  kLarge8BitIcon
  
  Большой 8-разрядный цветной значок. Соответствующий тип ресурса:'icl8'.
  
  Доступный в OS X v10.0 и позже.
  Не доступный 64-разрядным приложениям.
- kSmallIcon
  
  kSmallIcon
  
  Маленький черно-белый значок с маской. Соответствующий тип ресурса:'ics#'.
  
  Доступный в OS X v10.0 и позже.
  Не доступный 64-разрядным приложениям.
- kSmall4BitIcon
  
  kSmall4BitIcon
  
  Маленький 4-разрядный цветной значок. Соответствующий тип ресурса:'ics4'.
  
  Доступный в OS X v10.0 и позже.
  Не доступный 64-разрядным приложениям.
- kSmall8BitIcon
  
  kSmall8BitIcon
  
  Маленький 8-разрядный цветной значок. Соответствующий тип ресурса:'ics8'.
  
  Доступный в OS X v10.0 и позже.
  Не доступный 64-разрядным приложениям.
- kicnsIconFamily
  
  kicnsIconFamily
  
  Доступный в OS X v10.0 и позже.
  Не доступный 64-разрядным приложениям.
Обсуждение

Эти константы используются в ioIconType поле DTPBRec блок параметра.
Недопустимая постоянная ссылка объема
Представляет недопустимый ссылочный номер объема.

Объявление

Swift

var kFSInvalidVolumeRefNum: Int { get }

Objective C

enum { kFSInvalidVolumeRefNum = 0 };

Константы
- kFSInvalidVolumeRefNum
  
  kFSInvalidVolumeRefNum
  
  Недопустимый ссылочный номер объема.
  
  Доступный в OS X v10.0 и позже.
Флаги итератора
Укажите, выполняет ли итератор итерации по поддеревьям или просто непосредственным дочерним элементам контейнера.

Объявление

Swift

typealias FSIteratorFlags = OptionBits

Objective C

enum { kFSIterateFlat = 0, kFSIterateSubtree = 1, kFSIterateDelete = 2, kFSIterateReserved = 0xFFFFFFFC }; typedef OptionBits FSIteratorFlags;

Константы
- kFSIterateFlat
  
  kFSIterateFlat
  
  Выполните итерации по непосредственным дочерним элементам контейнера только.
  
  Доступный в OS X v10.0 и позже.
- kFSIterateSubtree
  
  kFSIterateSubtree
  
  Выполните итерации по всему поддереву, базированному в контейнере.
  
  Доступный в OS X v10.0 и позже.
- kFSIterateDelete
  
  kFSIterateDelete
  
  Доступный в OS X v10.0 и позже.
- kFSIterateReserved
  
  kFSIterateReserved
  
  Доступный в OS X v10.0 и позже.
Оператор импорта

Objective C

@import CoreServices;

Swift

import CoreServices

Доступность

Доступный в OS X v10.0 и позже.
kAsyncMountInProgress
Объявление

Swift

var kAsyncMountInProgress: Int { get } var kAsyncMountComplete: Int { get } var kAsyncUnmountInProgress: Int { get } var kAsyncUnmountComplete: Int { get } var kAsyncEjectInProgress: Int { get } var kAsyncEjectComplete: Int { get }

Objective C

enum { kAsyncMountInProgress = 1, kAsyncMountComplete = 2, kAsyncUnmountInProgress = 3, kAsyncUnmountComplete = 4, kAsyncEjectInProgress = 5, kAsyncEjectComplete = 6 };

Константы
- kAsyncMountInProgress
  
  kAsyncMountInProgress
  
  Доступный в OS X v10.2 и позже.
- kAsyncMountComplete
  
  kAsyncMountComplete
  
  Доступный в OS X v10.2 и позже.
- kAsyncUnmountInProgress
  
  kAsyncUnmountInProgress
  
  Доступный в OS X v10.2 и позже.
- kAsyncUnmountComplete
  
  kAsyncUnmountComplete
  
  Доступный в OS X v10.2 и позже.
- kAsyncEjectInProgress
  
  kAsyncEjectInProgress
  
  Доступный в OS X v10.2 и позже.
- kAsyncEjectComplete
  
  kAsyncEjectComplete
  
  Доступный в OS X v10.2 и позже.
Опции подписки уведомления
Опции, которые могут быть указаны во время подписки.

Объявление

Swift

var kFNNoImplicitAllSubscription: Int { get } var kFNNotifyInBackground: Int { get }

Objective C

enum { kFNNoImplicitAllSubscription = (1 << 0), kFNNotifyInBackground = (1 << 1) };

Константы
- kFNNoImplicitAllSubscription
  
  kFNNoImplicitAllSubscription
  
  Укажите эту опцию, если Вы не хотите получать уведомления по этой подписке когда FNNotifyAll вызывается. По умолчанию любая подписка является также неявно подпиской к подстановочным уведомлениям.
  
  Доступный в OS X v10.1 и позже.
- kFNNotifyInBackground
  
  kFNNotifyInBackground
  
  Укажите эту опцию, если Вы хотите получить уведомления по этой подписке, когда Ваше приложение находится в фоне. По умолчанию, когда Ваше приложение станет передним планом, уведомления будут объединены и и поставлены.
  
  Доступный в OS X v10.3 и позже.
kHFSCatalogNodeIDsReusedBit
Объявление

Swift

var kHFSCatalogNodeIDsReusedBit: UInt32 { get } var kHFSCatalogNodeIDsReusedMask: UInt32 { get }

Objective C

enum { kHFSCatalogNodeIDsReusedBit = 12, kHFSCatalogNodeIDsReusedMask = 1 << kHFSCatalogNodeIDsReusedBit };

Константы
- kHFSCatalogNodeIDsReusedBit
  
  kHFSCatalogNodeIDsReusedBit
  
  Доступный в OS X v10.0 и позже.
- kHFSCatalogNodeIDsReusedMask
  
  kHFSCatalogNodeIDsReusedMask
  
  Доступный в OS X v10.0 и позже.
Константы большого объема
Объявление

Swift

var kWidePosOffsetBit: Int { get } var kUseWidePositioning: Int { get } var kMaximumBlocksIn4GB: Int { get }

Objective C

enum { kWidePosOffsetBit = 8, kUseWidePositioning = (1 << kWidePosOffsetBit ), kMaximumBlocksIn4GB = 0x007FFFFF };

Константы
- kWidePosOffsetBit
  
  kWidePosOffsetBit
  
  Доступный в OS X v10.0 и позже.
- kUseWidePositioning
  
  kUseWidePositioning
  
  Доступный в OS X v10.0 и позже.
- kMaximumBlocksIn4GB
  
  kMaximumBlocksIn4GB
  
  Доступный в OS X v10.0 и позже.
Отображение кодовых констант
Укажите тип объекта отобразиться или возвратиться.

Объявление

Swift

var kOwnerID2Name: Int { get } var kGroupID2Name: Int { get } var kOwnerName2ID: Int { get } var kGroupName2ID: Int { get } var kReturnNextUser: Int { get } var kReturnNextGroup: Int { get } var kReturnNextUG: Int { get }

Objective C

enum { kOwnerID2Name = 1, kGroupID2Name = 2, kOwnerName2ID = 3, kGroupName2ID = 4, kReturnNextUser = 1, kReturnNextGroup = 2, kReturnNextUG = 3 };

Константы
- kOwnerID2Name
  
  kOwnerID2Name
  
  Отобразите идентификатор пользователя на имя пользователя. Используемый с PBHMapIDSync или PBHMapIDAsync функции.
  
  Доступный в OS X v10.0 и позже.
- kGroupID2Name
  
  kGroupID2Name
  
  Отобразите группу ID на название группы. Используемый с PBHMapIDSync или PBHMapIDAsync функции.
  
  Доступный в OS X v10.0 и позже.
- kOwnerName2ID
  
  kOwnerName2ID
  
  Отобразите имя пользователя на идентификатор пользователя. Используемый с PBHMapNameSync или PBHMapNameAsync функции.
  
  Доступный в OS X v10.0 и позже.
- kGroupName2ID
  
  kGroupName2ID
  
  Отобразите название группы на группу ID. Используемый с PBHMapNameSync или PBHMapNameAsync функции.
  
  Доступный в OS X v10.0 и позже.
- kReturnNextUser
  
  kReturnNextUser
  
  Возвратите следующую пользовательскую запись.
  
  Доступный в OS X v10.0 и позже.
- kReturnNextGroup
  
  kReturnNextGroup
  
  Возвратите следующую запись группы.
  
  Доступный в OS X v10.0 и позже.
- kReturnNextUG
  
  kReturnNextUG
  
  Возвратите следующего пользователя или запись группы.
  
  Доступный в OS X v10.0 и позже.
Обсуждение

Эти константы используются в ioObjType поле ObjParam блок параметра. Первые четыре константы передаются PBHMapIDSync , PBHMapIDAsync , PBHMapNameSync , и PBHMapNameAsync функции для указания отображения, которое будет выполняться. Последние три константы передаются PBGetUGEntrySync или PBGetUGEntryAsync функции для указания типа объекта, который будет возвращен.
Опции преобразования пути
Укажите, как путь преобразовывается в FSRef структура функцией FSPathMakeRefWithOptions.

Объявление

Swift

var kFSPathMakeRefDefaultOptions: Int { get } var kFSPathMakeRefDoNotFollowLeafSymlink: Int { get }

Objective C

enum { kFSPathMakeRefDefaultOptions = 0, kFSPathMakeRefDoNotFollowLeafSymlink = 0x01 };

Константы
- kFSPathMakeRefDefaultOptions
  
  kFSPathMakeRefDefaultOptions
  
  Используйте опции по умолчанию.
  
  Доступный в OS X v10.4 и позже.
- kFSPathMakeRefDoNotFollowLeafSymlink
  
  kFSPathMakeRefDoNotFollowLeafSymlink
  
  При преобразовании пути, относящегося к символьной ссылке, не идите по ссылке. Новое FSRef должен относиться к самой ссылке.
  
  Доступный в OS X v10.4 и позже.
Константы режима позиции
Вместе со смещением, укажите позицию в ветвлении.

Объявление

Swift

var fsAtMark: Int { get } var fsFromStart: Int { get } var fsFromLEOF: Int { get } var fsFromMark: Int { get }

Objective C

enum { fsAtMark = 0, fsFromStart = 1, fsFromLEOF = 2, fsFromMark = 3 };

Константы
- fsAtMark
  
  fsAtMark
  
  Начальная точка является текущей позицией пути доступа. Смещение проигнорировано.
  
  Доступный в OS X v10.0 и позже.
- fsFromStart
  
  fsFromStart
  
  Начальная точка является байтами смещения от запуска ветвления. Смещение должно быть неотрицательным.
  
  Доступный в OS X v10.0 и позже.
- fsFromLEOF
  
  fsFromLEOF
  
  Начальная точка является байтами смещения от логического конца ветвления. Смещение не должно быть положительным.
  
  Доступный в OS X v10.0 и позже.
- fsFromMark
  
  fsFromMark
  
  Начальная точка является байтами смещения от текущей позиции пути доступа. Смещение может быть положительным или отрицательным.
  
  Доступный в OS X v10.0 и позже.
Обсуждение

Эти константы используются в ioPosMode и positionMode поля и параметры HFS и HFS Плюс функции доступа к файлу. Эти функции включают тех для чтения от и записи в файлы или ветвлений, менять текущее положение в файле или ветвлении, изменении размера файла или ветвления и выделения площади к файлу или ветвлению.

Для FSReadFork и FSWriteFork вызовы, можно также добавить любой из pleaseCacheMask или noCacheMask константы, чтобы подсказать, должны ли данные кэшироваться или нет. Посмотрите Константы Кэша.
Константы корневого каталога
Укажите каталог IDs корневого каталога объема и его родителя.

Объявление

Swift

var fsRtParID: Int { get } var fsRtDirID: Int { get }

Objective C

enum { fsRtParID = 1, fsRtDirID = 2 };

Константы
- fsRtParID
  
  fsRtParID
  
  Представляет каталог ID родительского каталога корневого каталога. Корневой каталог не имеет никакого родителя, эта константа используется при указании корневого каталога к функциям, требующим, чтобы родительский каталог ID идентифицировал каталоги.
  
  Доступный в OS X v10.0 и позже.
- fsRtDirID
  
  fsRtDirID
  
  Представляет каталог ID корневого каталога объема.
  
  Доступный в OS X v10.0 и позже.
Константы идентификатора пользователя
Укажите рядового пользователя IDs для общих каталогов.

Объявление

Swift

var knoUser: Int { get } var kadministratorUser: Int { get }

Objective C

enum { knoUser = 0, kadministratorUser = 1 };

Константы
- knoUser
  
  knoUser
  
  Доступный в OS X v10.0 и позже.
- kadministratorUser
  
  kadministratorUser
  
  Доступный в OS X v10.0 и позже.
Константы полномочий пользователя
Укажите полномочия пользователя для каталога на удаленном объеме.

Объявление

Swift

var kioACUserNoSeeFolderBit: Int { get } var kioACUserNoSeeFolderMask: Int { get } var kioACUserNoSeeFilesBit: Int { get } var kioACUserNoSeeFilesMask: Int { get } var kioACUserNoMakeChangesBit: Int { get } var kioACUserNoMakeChangesMask: Int { get } var kioACUserNotOwnerBit: Int { get } var kioACUserNotOwnerMask: Int { get }

Objective C

enum { kioACUserNoSeeFolderBit = 0, kioACUserNoSeeFolderMask = 0x01, kioACUserNoSeeFilesBit = 1, kioACUserNoSeeFilesMask = 0x02, kioACUserNoMakeChangesBit = 2, kioACUserNoMakeChangesMask = 0x04, kioACUserNotOwnerBit = 7, kioACUserNotOwnerMask = 0x80 };

Константы
- kioACUserNoSeeFolderBit
  
  kioACUserNoSeeFolderBit
  
  Набор, если пользователь не имеет, “Видит Папки” полномочия. Без “Видят Папки” полномочия, пользователь не видят другие каталоги в указанном каталоге.
  
  Доступный в OS X v10.0 и позже.
- kioACUserNoSeeFolderMask
  
  kioACUserNoSeeFolderMask
  
  Тесты, если пользователь имеет, “Видят Папки” полномочия.
  
  Доступный в OS X v10.0 и позже.
- kioACUserNoSeeFilesBit
  
  kioACUserNoSeeFilesBit
  
  Набор, если пользователь не имеет, “Видит Файлы” полномочия. Без “Видят Файлы” полномочия, пользователь не может открыть документы или приложения в указанном каталоге.
  
  Доступный в OS X v10.0 и позже.
- kioACUserNoSeeFilesMask
  
  kioACUserNoSeeFilesMask
  
  Тесты, если пользователь имеет, “Видят Файлы” полномочия.
  
  Доступный в OS X v10.0 и позже.
- kioACUserNoMakeChangesBit
  
  kioACUserNoMakeChangesBit
  
  Набор, если пользователь не имеет, “Делает Изменения” полномочиями. Без “Делают Изменения” полномочиями, пользователь не может создать, изменить, переименовать или удалить любой файл или каталог в указанном каталоге.
  
  Доступный в OS X v10.0 и позже.
- kioACUserNoMakeChangesMask
  
  kioACUserNoMakeChangesMask
  
  Тесты, если пользователь имеет, “Делают Изменения” полномочиями.
  
  Доступный в OS X v10.0 и позже.
- kioACUserNotOwnerBit
  
  kioACUserNotOwnerBit
  
  Набор, если пользователь не является владельцем каталога.
  
  Доступный в OS X v10.0 и позже.
- kioACUserNotOwnerMask
  
  kioACUserNotOwnerMask
  
  Тесты, является ли пользователь владельцем каталога.
  
  Доступный в OS X v10.0 и позже.
Обсуждение

Эти константы используются в ioACUser поле HFileInfo и DirInfo структуры, возвращенные PBGetCatInfoSync и PBGetCatInfoAsync функции.
Константы атрибута объема
Константы позиции двоичного разряда, указывающие атрибуты объема.

Объявление

Swift

var bLimitFCBs: Int { get } var bLocalWList: Int { get } var bNoMiniFndr: Int { get } var bNoVNEdit: Int { get } var bNoLclSync: Int { get } var bTrshOffLine: Int { get } var bNoSwitchTo: Int { get } var bNoDeskItems: Int { get } var bNoBootBlks: Int { get } var bAccessCntl: Int { get } var bNoSysDir: Int { get } var bHasExtFSVol: Int { get } var bHasOpenDeny: Int { get } var bHasCopyFile: Int { get } var bHasMoveRename: Int { get } var bHasDesktopMgr: Int { get } var bHasShortName: Int { get } var bHasFolderLock: Int { get } var bHasPersonalAccessPrivileges: Int { get } var bHasUserGroupList: Int { get } var bHasCatSearch: Int { get } var bHasFileIDs: Int { get } var bHasBTreeMgr: Int { get } var bHasBlankAccessPrivileges: Int { get } var bSupportsAsyncRequests: Int { get } var bSupportsTrashVolumeCache: Int { get }

Objective C

enum { bLimitFCBs = 31, bLocalWList = 30, bNoMiniFndr = 29, bNoVNEdit = 28, bNoLclSync = 27, bTrshOffLine = 26, bNoSwitchTo = 25, bNoDeskItems = 20, bNoBootBlks = 19, bAccessCntl = 18, bNoSysDir = 17, bHasExtFSVol = 16, bHasOpenDeny = 15, bHasCopyFile = 14, bHasMoveRename = 13, bHasDesktopMgr = 12, bHasShortName = 11, bHasFolderLock = 10, bHasPersonalAccessPrivileges = 9, bHasUserGroupList = 8, bHasCatSearch = 7, bHasFileIDs = 6, bHasBTreeMgr = 5, bHasBlankAccessPrivileges = 4, bSupportsAsyncRequests = 3, bSupportsTrashVolumeCache = 2 }; enum { bHasDirectIO = 1 };

Константы
- bLimitFCBs
  
  bLimitFCBs
  
  Средство поиска ограничивает число блоков управления файлом, привыкших во время копирования к 8 вместо 16.
  
  Доступный в OS X v10.0 и позже.
- bLocalWList
  
  bLocalWList
  
  Средство поиска использует возвращенный дескриптор совместно используемого тома для своего локального списка окна.
  
  Доступный в OS X v10.0 и позже.
- bNoMiniFndr
  
  bNoMiniFndr
  
  Зарезервированный; всегда набор к 1.
  
  Доступный в OS X v10.0 и позже.
- bNoVNEdit
  
  bNoVNEdit
  
  Имя этого объема не может быть отредактировано.
  
  Доступный в OS X v10.0 и позже.
- bNoLclSync
  
  bNoLclSync
  
  Не позволяйте Средству поиска изменить дату модификации.
  
  Доступный в OS X v10.0 и позже.
- bTrshOffLine
  
  bTrshOffLine
  
  Любое время этот объем идет оффлайн, он масштабируется к Мусору и размонтирован.
  
  Доступный в OS X v10.0 и позже.
- bNoSwitchTo
  
  bNoSwitchTo
  
  Средство поиска не переключит запуск ни на какое приложение на этом объеме.
  
  Доступный в OS X v10.0 и позже.
- bNoDeskItems
  
  bNoDeskItems
  
  Не помещайте объекты в этот объем на рабочем столе Средства поиска.
  
  Доступный в OS X v10.0 и позже.
- bNoBootBlks
  
  bNoBootBlks
  
  Этот объем не является объемом запуска. Пункт меню Startup отключен. Блоки начальной загрузки не копируются во время операций копии.
  
  Доступный в OS X v10.0 и позже.
- bAccessCntl
  
  bAccessCntl
  Этот объем поддерживает AppleTalk интерфейсы контроля доступа AFP. Следующие функции поддерживаются:
  
  PBHGetLogInInfoSync
  
  PBHGetLogInInfoAsync
  
  PBHGetDirAccessSync
  
  PBHGetDirAccessAsync
  
  PBHSetDirAccessSync
  
  PBHSetDirAccessAsync
  
  PBHMapIDSync
  
  PBHMapIDAsync
  
  PBHMapNameSync
  
  PBHMapNameAsync
  
  Используются специальные значки папок. Команда меню Access Privileges включена для элементов папки и диска. ioFlAttrib поле блока параметра передало PBGetCatInfoSync и PBGetCatInfoSync функции, как предполагается, допустимы.
  Доступный в OS X v10.0 и позже.
- bNoSysDir
  
  bNoSysDir
  
  Этот объем не поддерживает системный каталог. Не переключайте запуск на этот объем.
  
  Доступный в OS X v10.0 и позже.
- bHasExtFSVol
  
  bHasExtFSVol
  
  Этот объем является внешним томом файловой системы.
  
  Доступный в OS X v10.0 и позже.
- bHasOpenDeny
  
  bHasOpenDeny
  
  Этот объем поддерживает PBHOpenDenySync , PBHOpenDenyAsync, PBHOpenRFDenySync и PBHOpenRFDenyAsync функции.
  
  Доступный в OS X v10.0 и позже.
- bHasCopyFile
  
  bHasCopyFile
  
  Этот объем поддерживает PBHCopyFileSync и PBHCopyFileAsync функции, который используется в копии и двойных операциях, если и источник и целевые объемы имеют тот же адрес сервера.
  
  Доступный в OS X v10.0 и позже.
- bHasMoveRename
  
  bHasMoveRename
  
  Этот объем поддерживает PBHMoveRenameSync и PBHMoveRenameAsync функции.
  
  Доступный в OS X v10.0 и позже.
- bHasDesktopMgr
  
  bHasDesktopMgr
  
  Этот объем поддерживает все настольные функции.
  
  Доступный в OS X v10.0 и позже.
- bHasShortName
  
  bHasShortName
  
  Этот объем поддерживает краткие названия AFP.
  
  Доступный в OS X v10.0 и позже.
- bHasFolderLock
  
  bHasFolderLock
  
  Папки на объеме могут быть заблокированы, и таким образом, они не могут быть удалены или переименованы.
  
  Доступный в OS X v10.0 и позже.
- bHasPersonalAccessPrivileges
  
  bHasPersonalAccessPrivileges
  
  Этому объему включили локальный совместный доступ к файлам.
  
  Доступный в OS X v10.0 и позже.
- bHasUserGroupList
  
  bHasUserGroupList
  
  Этот объем поддерживает файл Пользователей и Групп и таким образом функции полномочия AFP.
  
  Доступный в OS X v10.0 и позже.
- bHasCatSearch
  
  bHasCatSearch
  
  Этот объем поддерживает PBCatSearchSync и PBCatSearchAsync функции.
  
  Доступный в OS X v10.0 и позже.
- bHasFileIDs
  
  bHasFileIDs
  
  Этот объем поддерживает функции идентификатора файла, включая PBExchangeFilesSync и PBExchangeFilesAsync функции.
  
  Доступный в OS X v10.0 и позже.
- bHasBTreeMgr
  
  bHasBTreeMgr
  
  Зарезервированный для внутреннего использования.
  
  Доступный в OS X v10.0 и позже.
- bHasBlankAccessPrivileges
  
  bHasBlankAccessPrivileges
  
  Этот объем поддерживает наследованные права доступа для папок (пустые права доступа).
  
  Доступный в OS X v10.0 и позже.
- bSupportsAsyncRequests
  
  bSupportsAsyncRequests
  
  В любое время этот объем правильно обрабатывает асинхронные запросы.
  
  Доступный в OS X v10.0 и позже.
- bSupportsTrashVolumeCache
  
  bSupportsTrashVolumeCache
  
  Доступный в OS X v10.0 и позже.
Обсуждение

Эти константы соответствуют позициям двоичного разряда в vMAttrib поле GetVolParmsInfoBuffer структура, возвращенная PBHGetVolParmsSync и PBHGetVolParmsAsync функции.
Блочные флаги регулятора громкости
Используемый в vcbFlags поле регулятора громкости блокирует для указания информации об объеме.

Объявление

Swift

var kVCBFlagsIdleFlushBit: Int { get } var kVCBFlagsIdleFlushMask: Int { get } var kVCBFlagsHFSPlusAPIsBit: Int { get } var kVCBFlagsHFSPlusAPIsMask: Int { get } var kVCBFlagsHardwareGoneBit: Int { get } var kVCBFlagsHardwareGoneMask: Int { get } var kVCBFlagsVolumeDirtyBit: Int { get } var kVCBFlagsVolumeDirtyMask: Int { get }

Objective C

enum { kVCBFlagsIdleFlushBit = 3, kVCBFlagsIdleFlushMask = 0x0008, kVCBFlagsHFSPlusAPIsBit = 4, kVCBFlagsHFSPlusAPIsMask = 0x0010, kVCBFlagsHardwareGoneBit = 5, kVCBFlagsHardwareGoneMask = 0x0020, kVCBFlagsVolumeDirtyBit = 15, kVCBFlagsVolumeDirtyMask = 0x8000 };

Константы
- kVCBFlagsIdleFlushBit
  
  kVCBFlagsIdleFlushBit
  
  Указывает, что объем должен быть сброшен во время простоя.
  
  Доступный в OS X v10.0 и позже.
- kVCBFlagsIdleFlushMask
  
  kVCBFlagsIdleFlushMask
  
  Сбрасывает объем во время простоя.
  
  Доступный в OS X v10.0 и позже.
- kVCBFlagsHFSPlusAPIsBit
  
  kVCBFlagsHFSPlusAPIsBit
  
  Указывает, что объем непосредственно реализует HFS Плюс APIs (вместо того, чтобы эмулировать их).
  
  Доступный в OS X v10.0 и позже.
- kVCBFlagsHFSPlusAPIsMask
  
  kVCBFlagsHFSPlusAPIsMask
  
  Объем непосредственно реализует HFS Плюс APIs.
  
  Доступный в OS X v10.0 и позже.
- kVCBFlagsHardwareGoneBit
  
  kVCBFlagsHardwareGoneBit
  
  Указывает, что дисковый драйвер возвратил a hardwareGoneErr в ответ на чтение или вызов записи.
  
  Доступный в OS X v10.0 и позже.
- kVCBFlagsHardwareGoneMask
  
  kVCBFlagsHardwareGoneMask
  
  Тесты, если дисковый драйвер возвратил a hardwareGoneErr в ответ на чтение или вызов записи.
  
  Доступный в OS X v10.0 и позже.
- kVCBFlagsVolumeDirtyBit
  
  kVCBFlagsVolumeDirtyBit
  
  Указывает, что информация об объеме изменилась с прошлого раза был сброшен объем.
  
  Доступный в OS X v10.0 и позже.
- kVCBFlagsVolumeDirtyMask
  
  kVCBFlagsVolumeDirtyMask
  
  Объем изменился с прошлого раза был сброшен объем.
  
  Доступный в OS X v10.0 и позже.
Обсуждение

Посмотрите VCB для описания блока регулятора громкости.
Константы атрибута информации об объеме
Определите атрибуты объема, возвращенные функциями PBHGetVInfoSync, PBHGetVInfoAsync, PBXGetVolInfoSync, и PBXGetVolInfoAsync.

Объявление

Swift

var kioVAtrbDefaultVolumeBit: Int { get } var kioVAtrbDefaultVolumeMask: Int { get } var kioVAtrbFilesOpenBit: Int { get } var kioVAtrbFilesOpenMask: Int { get } var kioVAtrbHardwareLockedBit: Int { get } var kioVAtrbHardwareLockedMask: Int { get } var kioVAtrbSoftwareLockedBit: Int { get } var kioVAtrbSoftwareLockedMask: Int { get }

Objective C

enum { kioVAtrbDefaultVolumeBit = 5, kioVAtrbDefaultVolumeMask = 0x0020, kioVAtrbFilesOpenBit = 6, kioVAtrbFilesOpenMask = 0x0040, kioVAtrbHardwareLockedBit = 7, kioVAtrbHardwareLockedMask = 0x0080, kioVAtrbSoftwareLockedBit = 15, kioVAtrbSoftwareLockedMask = 0x8000 };

Константы
- kioVAtrbDefaultVolumeBit
  
  kioVAtrbDefaultVolumeBit
  
  Указывает, что объем является объемом по умолчанию.
  
  Доступный в OS X v10.0 и позже.
- kioVAtrbDefaultVolumeMask
  
  kioVAtrbDefaultVolumeMask
  
  Тесты, если объем является объемом по умолчанию.
  
  Доступный в OS X v10.0 и позже.
- kioVAtrbFilesOpenBit
  
  kioVAtrbFilesOpenBit
  
  Указывает, что существуют открытые файлы или итераторы.
  
  Доступный в OS X v10.0 и позже.
- kioVAtrbFilesOpenMask
  
  kioVAtrbFilesOpenMask
  
  Тесты, если существуют открытые файлы или итераторы.
  
  Доступный в OS X v10.0 и позже.
- kioVAtrbHardwareLockedBit
  
  kioVAtrbHardwareLockedBit
  
  Указывает, что объем заблокирован аппаратной установкой. На OS X Файловый менеджер только устанавливает программное обеспечение заблокированный бит для CDs и других носителей только для чтения; это не устанавливает аппаратные средства заблокированный бит.
  
  Доступный в OS X v10.0 и позже.
- kioVAtrbHardwareLockedMask
  
  kioVAtrbHardwareLockedMask
  
  Тесты, если объем заблокирован аппаратной установкой.
  
  Доступный в OS X v10.0 и позже.
- kioVAtrbSoftwareLockedBit
  
  kioVAtrbSoftwareLockedBit
  
  Указывает, что объем заблокирован программным обеспечением.
  
  Доступный в OS X v10.0 и позже.
- kioVAtrbSoftwareLockedMask
  
  kioVAtrbSoftwareLockedMask
  
  Тесты, если объем заблокирован программным обеспечением.
  
  Доступный в OS X v10.0 и позже.
Обсуждение

Эти константы используются в ioVAtrb поле HVolumeParam блок параметра, возвращенный PBHGetVInfoSync и PBHGetVInfoAsync функции, и в ioVAtrb поле XVolumeParam блок параметра, возвращенный PBXGetVolInfoSync и PBXGetVolInfoAsync функции.
Растровые константы информации об объеме
Укажите что информацию об объеме установить или получить.

Объявление

Swift

var kFSVolInfoNone: Int { get } var kFSVolInfoCreateDate: Int { get } var kFSVolInfoModDate: Int { get } var kFSVolInfoBackupDate: Int { get } var kFSVolInfoCheckedDate: Int { get } var kFSVolInfoFileCount: Int { get } var kFSVolInfoDirCount: Int { get } var kFSVolInfoSizes: Int { get } var kFSVolInfoBlocks: Int { get } var kFSVolInfoNextAlloc: Int { get } var kFSVolInfoRsrcClump: Int { get } var kFSVolInfoDataClump: Int { get } var kFSVolInfoNextID: Int { get } var kFSVolInfoFinderInfo: Int { get } var kFSVolInfoFlags: Int { get } var kFSVolInfoFSInfo: Int { get } var kFSVolInfoDriveInfo: Int { get } var kFSVolInfoGettableInfo: Int { get } var kFSVolInfoSettableInfo: Int { get }

Objective C

enum { kFSVolInfoNone = 0x0000, kFSVolInfoCreateDate = 0x0001, kFSVolInfoModDate = 0x0002, kFSVolInfoBackupDate = 0x0004, kFSVolInfoCheckedDate = 0x0008, kFSVolInfoFileCount = 0x0010, kFSVolInfoDirCount = 0x0020, kFSVolInfoSizes = 0x0040, kFSVolInfoBlocks = 0x0080, kFSVolInfoNextAlloc = 0x0100, kFSVolInfoRsrcClump = 0x0200, kFSVolInfoDataClump = 0x0400, kFSVolInfoNextID = 0x0800, kFSVolInfoFinderInfo = 0x1000, kFSVolInfoFlags = 0x2000, kFSVolInfoFSInfo = 0x4000, kFSVolInfoDriveInfo = 0x8000, kFSVolInfoGettableInfo = 0xFFFF, kFSVolInfoSettableInfo = 0x3004 };

Константы
- kFSVolInfoNone
  
  kFSVolInfoNone
  
  Никакая информация об объеме.
  
  Доступный в OS X v10.0 и позже.
- kFSVolInfoCreateDate
  
  kFSVolInfoCreateDate
  
  Получите дату создания объема.
  
  Доступный в OS X v10.0 и позже.
- kFSVolInfoModDate
  
  kFSVolInfoModDate
  
  Получите дату последнего изменения объема.
  
  Доступный в OS X v10.0 и позже.
- kFSVolInfoBackupDate
  
  kFSVolInfoBackupDate
  
  Получите или назначьте дату последнего резервного копирования объема.
  
  Доступный в OS X v10.0 и позже.
- kFSVolInfoCheckedDate
  
  kFSVolInfoCheckedDate
  
  Получите дату, что объем был в последний раз проверен на непротиворечивость.
  
  Доступный в OS X v10.0 и позже.
- kFSVolInfoFileCount
  
  kFSVolInfoFileCount
  
  Получите число файлов на объеме.
  
  Доступный в OS X v10.0 и позже.
- kFSVolInfoDirCount
  
  kFSVolInfoDirCount
  
  Получите число каталогов на объеме.
  
  Доступный в OS X v10.0 и позже.
- kFSVolInfoSizes
  
  kFSVolInfoSizes
  
  Получите общее количество байтов на объеме и числе неиспользованных байтов на объеме (в totalBytes и freeBytes поля).
  
  Доступный в OS X v10.0 и позже.
- kFSVolInfoBlocks
  
  kFSVolInfoBlocks
  
  Получите информацию о блоке: размер блока, число общих блоков на объеме и число свободных блоков на объеме.
  
  Доступный в OS X v10.0 и позже.
- kFSVolInfoNextAlloc
  
  kFSVolInfoNextAlloc
  
  Получите адрес, в котором можно запустить следующее выделение.
  
  Доступный в OS X v10.0 и позже.
- kFSVolInfoRsrcClump
  
  kFSVolInfoRsrcClump
  
  Получите размер глыбы ветви ресурсов.
  
  Доступный в OS X v10.0 и позже.
- kFSVolInfoDataClump
  
  kFSVolInfoDataClump
  
  Получите размер глыбы ветви данных.
  
  Доступный в OS X v10.0 и позже.
- kFSVolInfoNextID
  
  kFSVolInfoNextID
  
  Получите следующий доступный узел каталога ID.
  
  Доступный в OS X v10.0 и позже.
- kFSVolInfoFinderInfo
  
  kFSVolInfoFinderInfo
  
  Получите или установите информацию о Средстве поиска объема.
  
  Доступный в OS X v10.0 и позже.
- kFSVolInfoFlags
  
  kFSVolInfoFlags
  
  Получите или установите флаги объема. Посмотрите Флаги информации об Объеме для получения дополнительной информации о флагах объема.
  
  Доступный в OS X v10.0 и позже.
- kFSVolInfoFSInfo
  
  kFSVolInfoFSInfo
  
  Получите файловую систему ID и подпись.
  
  Доступный в OS X v10.0 и позже.
- kFSVolInfoDriveInfo
  
  kFSVolInfoDriveInfo
  
  Получите информацию о диске: число диска и ссылочный номер драйвера.
  
  Доступный в OS X v10.0 и позже.
- kFSVolInfoGettableInfo
  
  kFSVolInfoGettableInfo
  
  Получите всю доступную информацию.
  
  Доступный в OS X v10.0 и позже.
- kFSVolInfoSettableInfo
  
  kFSVolInfoSettableInfo
  
  Установите всю устанавливаемую информацию. В настоящее время это - резервная дата, информация о Средстве поиска и флаги.
  
  Доступный в OS X v10.0 и позже.
Обсуждение

Эти константы используются с FSVolumeInfoBitmap тип данных для указания, что информацию об объеме установить или получить с функциями FSSetVolumeInfo и FSGetVolumeInfo , и их соответствующий параметр блокирует вызовы.
Флаги информации об объеме
Используемый FSVolumeInfo структура для указания характеристик объема.

Объявление

Swift

var kFSVolFlagDefaultVolumeBit: Int { get } var kFSVolFlagDefaultVolumeMask: Int { get } var kFSVolFlagFilesOpenBit: Int { get } var kFSVolFlagFilesOpenMask: Int { get } var kFSVolFlagHardwareLockedBit: Int { get } var kFSVolFlagHardwareLockedMask: Int { get } var kFSVolFlagSoftwareLockedBit: Int { get } var kFSVolFlagSoftwareLockedMask: Int { get }

Objective C

enum { kFSVolFlagDefaultVolumeBit = 5, kFSVolFlagDefaultVolumeMask = 0x0020, kFSVolFlagFilesOpenBit = 6, kFSVolFlagFilesOpenMask = 0x0040, kFSVolFlagHardwareLockedBit = 7, kFSVolFlagHardwareLockedMask = 0x0080, kFSVolFlagSoftwareLockedBit = 15, kFSVolFlagSoftwareLockedMask = 0x8000 };

Константы
- kFSVolFlagDefaultVolumeBit
  
  kFSVolFlagDefaultVolumeBit
  
  Набор, если объем является объемом по умолчанию.
  
  Доступный в OS X v10.0 и позже.
- kFSVolFlagDefaultVolumeMask
  
  kFSVolFlagDefaultVolumeMask
  
  Указывает, что объем является объемом по умолчанию.
  
  Доступный в OS X v10.0 и позже.
- kFSVolFlagFilesOpenBit
  
  kFSVolFlagFilesOpenBit
  
  Набор, если существуют открытые файлы или итераторы.
  
  Доступный в OS X v10.0 и позже.
- kFSVolFlagFilesOpenMask
  
  kFSVolFlagFilesOpenMask
  
  Указывает, что существуют открытые файлы или итераторы.
  
  Доступный в OS X v10.0 и позже.
- kFSVolFlagHardwareLockedBit
  
  kFSVolFlagHardwareLockedBit
  
  Набор, если объем заблокирован аппаратной установкой. На OS X Файловый менеджер только устанавливает программное обеспечение заблокированный бит для CDs и других носителей только для чтения; это не устанавливает аппаратные средства заблокированный бит.
  
  Доступный в OS X v10.0 и позже.
- kFSVolFlagHardwareLockedMask
  
  kFSVolFlagHardwareLockedMask
  
  Указывает, что объем заблокирован аппаратной установкой.
  
  Доступный в OS X v10.0 и позже.
- kFSVolFlagSoftwareLockedBit
  
  kFSVolFlagSoftwareLockedBit
  
  Набор, если объем заблокирован программным обеспечением.
  
  Доступный в OS X v10.0 и позже.
- kFSVolFlagSoftwareLockedMask
  
  kFSVolFlagSoftwareLockedMask
  
  Указывает, что объем заблокирован программным обеспечением.
  
  Доступный в OS X v10.0 и позже.
Обсуждение

Посмотрите flags поле FSVolumeInfo структура.
Объем монтирует флаги
Определите флаги, используемые объемом, монтирующим информационные структуры.

Объявление

Swift

var volMountNoLoginMsgFlagBit: Int { get } var volMountNoLoginMsgFlagMask: Int { get } var volMountExtendedFlagsBit: Int { get } var volMountExtendedFlagsMask: Int { get } var volMountInteractBit: Int { get } var volMountInteractMask: Int { get } var volMountChangedBit: Int { get } var volMountChangedMask: Int { get } var volMountFSReservedMask: Int { get } var volMountSysReservedMask: Int { get }

Objective C

enum { volMountNoLoginMsgFlagBit = 0, volMountNoLoginMsgFlagMask = 0x0001, volMountExtendedFlagsBit = 7, volMountExtendedFlagsMask = 0x0080, volMountInteractBit = 15, volMountInteractMask = 0x8000, volMountChangedBit = 14, volMountChangedMask = 0x4000, volMountFSReservedMask = 0x00FF, volMountSysReservedMask = 0xFF00 };

Константы
- volMountNoLoginMsgFlagBit
  
  volMountNoLoginMsgFlagBit
  
  Указывает, что будут подавлены любое сообщение входа в систему или диалоговое окно приветствия.
  
  Доступный в OS X v10.0 и позже.
- volMountNoLoginMsgFlagMask
  
  volMountNoLoginMsgFlagMask
  
  Говорит файловой системе подавлять любое сообщение входа в систему или диалоговое окно приветствия.
  
  Доступный в OS X v10.0 и позже.
- volMountExtendedFlagsBit
  
  volMountExtendedFlagsBit
  
  Указывает, что монтирующейся информацией является a AFPXVolMountInfo запись для Версии клиента 3.7 AppleShare и позже.
  
  Доступный в OS X v10.0 и позже.
- volMountExtendedFlagsMask
  
  volMountExtendedFlagsMask
  
  Говорит файловой системе, что монтирующаяся информация AFPXVolMountInfo запись для Версии клиента 3.7 AppleShare и позже.
  
  Доступный в OS X v10.0 и позже.
- volMountInteractBit
  
  volMountInteractBit
  
  Указывает, что безопасно для файловой системы выполнить взаимодействие с пользователем для монтирования объема.
  
  Доступный в OS X v10.0 и позже.
- volMountInteractMask
  
  volMountInteractMask
  
  Говорит файловой системе, что безопасно выполнить взаимодействие с пользователем для монтирования объема.
  
  Доступный в OS X v10.0 и позже.
- volMountChangedBit
  
  volMountChangedBit
  
  Указывает, что объем был смонтирован, но должен быть обновлен объем, монтирующий информационную запись.
  
  Доступный в OS X v10.0 и позже.
- volMountChangedMask
  
  volMountChangedMask
  
  Тесты, если должен быть обновлен объем, монтирующий информационную запись.
  
  Доступный в OS X v10.0 и позже.
- volMountFSReservedMask
  
  volMountFSReservedMask
  
  Зарезервированный.
  
  Доступный в OS X v10.0 и позже.
- volMountSysReservedMask
  
  volMountSysReservedMask
  
  Зарезервированный.
  
  Доступный в OS X v10.0 и позже.
Обсуждение

Биты 0-7 определяются каждой файловой системой для ее собственного использования; биты 8-15 резервируются для системного использования Apple. Эти константы используются в flags поля AFPVolMountInfo, AFPXVolMountInfo , и VolumeMountInfoHeader структуры.

Коды результата

Наиболее распространенные коды результата, возвращенные функциями Файлового менеджера, упоминаются ниже.

dirFulErr

Полный каталог File.

Значение

- 33

Описание

Полный каталог File.

Доступный в OS X v10.0 и позже.
dskFulErr

Диск или полный объем.

Значение

- 34

Описание

Диск или полный объем.

Доступный в OS X v10.0 и позже.
nsvErr

Объем, не найденный.

Значение

- 35

Описание

Объем, не найденный.

Доступный в OS X v10.0 и позже.
ioErr

Ошибка I/O.

Значение

- 36

Описание

Ошибка I/O.

Доступный в OS X v10.0 и позже.
bdNamErr

Плохое имя файла или имя тома.

Значение

- 37

Описание

Плохое имя файла или имя тома.

Доступный в OS X v10.0 и позже.
fnOpnErr

Файл, не открытый.

Значение

- 38

Описание

Файл, не открытый.

Доступный в OS X v10.0 и позже.
eofErr

Логический конец файла достиг.

Значение

- 39

Описание

Логический конец файла достиг.

Доступный в OS X v10.0 и позже.
проблема

Попытайтесь расположить метку перед запуском файла.

Значение

- 40

Описание

Попытайтесь расположить метку перед запуском файла.

Доступный в OS X v10.0 и позже.
mFulErr

Память, полная (открытый) или файл, не будет соответствовать (загружаются)

Значение

- 41

Описание

Память, полная (открытый) или файл, не будет соответствовать (загружаются)

Доступный в OS X v10.0 и позже.
tmfoErr

Слишком много открытых файлов.

Значение

- 42

Описание

Слишком много открытых файлов.

Доступный в OS X v10.0 и позже.
fnfErr

Файл или каталог, не найденный; неполный путь.

Значение

- 43

Описание

Файл или каталог, не найденный; неполный путь.

Доступный в OS X v10.0 и позже.
wPrErr

Объем заблокирован через аппаратные средства.

Значение

- 44

Описание

Объем заблокирован через аппаратные средства.

Доступный в OS X v10.0 и позже.
fLckdErr

Файл заблокирован.

Значение

- 45

Описание

Файл заблокирован.

Доступный в OS X v10.0 и позже.
vLckdErr

Объем заблокирован через программное обеспечение.

Значение

- 46

Описание

Объем заблокирован через программное обеспечение.

Доступный в OS X v10.0 и позже.
fBsyErr

Значение

- 47

Описание

Один или более файлов открыты

Файл занят

Каталог не пуст.

Доступный в OS X v10.0 и позже.
dupFNErr

Значение

- 48

Описание

Двойное имя файла и версия

Целевой файл уже существует

Файл найден вместо папки

Доступный в OS X v10.0 и позже.
opWrErr

Файл уже открывается для записи.

Значение

- 49

Описание

Файл уже открывается для записи.

Доступный в OS X v10.0 и позже.
paramErr

Недопустимое значение передается в параметре. Ваше приложение передало недопустимый параметр для диалоговых опций.

Значение

- 50

Описание

Недопустимое значение передается в параметре. Ваше приложение передало недопустимый параметр для диалоговых опций.

Доступный в OS X v10.0 и позже.
rfNumErr

Число недопустимой ссылки.

Значение

- 51

Описание

Число недопустимой ссылки.

Доступный в OS X v10.0 и позже.
gfpErr

Ошибка во время GetFPos, PBGetFPosSync или PBGetFPosAsync.

Значение

- 52

Описание

Ошибка во время GetFPos, PBGetFPosSync или PBGetFPosAsync.

Доступный в OS X v10.0 и позже.
volOffLinErr

Объем является оффлайновым.

Значение

- 53

Описание

Объем является оффлайновым.

Доступный в OS X v10.0 и позже.
permErr

Значение

- 54

Описание

Попытайтесь открыть заблокированный файл для записи

Ошибка полномочий

Доступный в OS X v10.0 и позже.
volOnLinErr

Объем уже онлайн.

Значение

- 55

Описание

Объем уже онлайн.

Доступный в OS X v10.0 и позже.
nsDrvErr

Никакой такой диск.

Значение

- 56

Описание

Никакой такой диск.

Доступный в OS X v10.0 и позже.
noMacDskErr

Не диск Macintosh.

Значение

- 57

Описание

Не диск Macintosh.

Доступный в OS X v10.0 и позже.
extFSErr

Объем принадлежит внешней файловой системе.

Значение

- 58

Описание

Объем принадлежит внешней файловой системе.

Доступный в OS X v10.0 и позже.
fsRnErr

Проблема во время переименовывает.

Значение

- 59

Описание

Проблема во время переименовывает.

Доступный в OS X v10.0 и позже.
badMDBErr

Плохой основной блок каталога.

Значение

- 60

Описание

Плохой основной блок каталога.

Доступный в OS X v10.0 и позже.
wrPermErr

Читайте разрешение записи / не позволяет писать.

Значение

- 61

Описание

Читайте разрешение записи / не позволяет писать.

Доступный в OS X v10.0 и позже.
lastDskErr

Значение

- 64

Описание

Доступный в OS X v10.0 и позже.
noDriveErr

Диск, не установленный.

Значение

- 64

Описание

Диск, не установленный.

Доступный в OS X v10.0 и позже.
firstDskErr

Значение

- 84

Описание

Доступный в OS X v10.0 и позже.
dirNFErr

Каталог, не найденный или неполный путь.

Значение

- 120

Описание

Каталог, не найденный или неполный путь.

Доступный в OS X v10.0 и позже.
tmwdoErr

Слишком много рабочих открытых каталогов.

Значение

- 121

Описание

Слишком много рабочих открытых каталогов.

Доступный в OS X v10.0 и позже.
badMovErr

Попытайтесь переместиться.

Значение

- 122

Описание

Попытайтесь переместиться.

Доступный в OS X v10.0 и позже.
wrgVolTypErr

Значение

- 123

Описание

Объем не поддерживает среду рабочего стола

Не объем HFS

Доступный в OS X v10.0 и позже.
volGoneErr

Объем сервера был разъединен.

Значение

- 124

Описание

Объем сервера был разъединен.

Доступный в OS X v10.0 и позже.
fsDSIntErr

неаппаратные средства внутренняя ошибка файловой системы.

Значение

- 127

Описание

неаппаратные средства внутренняя ошибка файловой системы.

Доступный в OS X v10.0 и позже.
fsmFFSNotFoundErr

Внешняя файловая система не существует.

Значение

- 431

Описание

Внешняя файловая система не существует.

Доступный в OS X v10.0 и позже.
fsmBusyFFSErr

Файловая система занята, не может быть удален.

Значение

- 432

Описание

Файловая система занята, не может быть удален.

Доступный в OS X v10.0 и позже.
fsmBadFFSNameErr

Длина имени не 1 <= длина <= 31

Значение

- 433

Описание

Длина имени не 1 <= длина <= 31

Доступный в OS X v10.0 и позже.
fsmBadFSDLenErr

Размер FSD, несовместимый с текущим FSM vers

Значение

- 434

Описание

Размер FSD, несовместимый с текущим FSM vers

Доступный в OS X v10.0 и позже.
fsmDuplicateFSIDErr

FSID уже существует.

Значение

- 435

Описание

FSID уже существует.

Доступный в OS X v10.0 и позже.
fsmBadFSDVersionErr

Версия FSM, несовместимая с FSD

Значение

- 436

Описание

Версия FSM, несовместимая с FSD

Доступный в OS X v10.0 и позже.
fsmNoAlternateStackErr

никакой альтернативный штабель для CI HFS

Значение

- 437

Описание

никакой альтернативный штабель для CI HFS

Доступный в OS X v10.0 и позже.
fsmUnknownFSMMessageErr

неизвестное сообщение передало FSM

Значение

- 438

Описание

неизвестное сообщение передало FSM

Доступный в OS X v10.0 и позже.
driverHardwareGoneErr

диск водительские аппаратные средства был разъединен

Значение

- 503

Описание

диск водительские аппаратные средства был разъединен

Доступный в OS X v10.0 и позже.
fidNotFound

Идентификатор файла, не найденный

Значение

- 1300

Описание

Идентификатор файла, не найденный

Доступный в OS X v10.0 и позже.
fidExists

Идентификатор файла уже существует

Значение

- 1301

Описание

Идентификатор файла уже существует

Доступный в OS X v10.0 и позже.
notAFileErr

Указанный файл является каталогом

Значение

- 1302

Описание

Указанный файл является каталогом

Доступный в OS X v10.0 и позже.
diffVolErr

Файлы на различных объемах

Значение

- 1303

Описание

Файлы на различных объемах

Доступный в OS X v10.0 и позже.
catChangedErr

Каталог изменился, и запись позиции каталога может быть недопустимой

Значение

- 1304

Описание

Каталог изменился, и запись позиции каталога может быть недопустимой

Доступный в OS X v10.0 и позже.
sameFileErr

Не может обмениваться файлом с собой

Значение

- 1306

Описание

Не может обмениваться файлом с собой

Доступный в OS X v10.0 и позже.
badFidErr

Идентификатор файла свисает или не соответствует с номером документа

Значение

- 1307

Описание

Идентификатор файла свисает или не соответствует с номером документа

Доступный в OS X v10.0 и позже.
notARemountErr

_Mount позволяет, только повторно монтирует и не получает тот

Значение

- 1308

Описание

_Mount позволяет, только повторно монтирует и не получает тот

Доступный в OS X v10.0 и позже.
fileBoundsErr

EOF файла, смещение, метка или размер являются слишком большими

Значение

- 1309

Описание

EOF файла, смещение, метка или размер являются слишком большими

Доступный в OS X v10.0 и позже.
fsDataTooBigErr

Файл или объем являются слишком большими для системы

Значение

- 1310

Описание

Файл или объем являются слишком большими для системы

Доступный в OS X v10.0 и позже.
volVMBusyErr

Не может извлечься, потому что объем используется VM

Значение

- 1311

Описание

Не может извлечься, потому что объем используется VM

Доступный в OS X v10.0 и позже.
badFCBErr

FCBRecPtr не допустим

Значение

- 1327

Описание

FCBRecPtr не допустим

Доступный в OS X v10.0 и позже.
errFSUnknownCall

Селектор не распознан этой файловой системой

Значение

- 1400

Описание

Селектор не распознан этой файловой системой

Доступный в OS X v10.0 и позже.
errFSBadFSRef

Значение

- 1401

Описание

FSRef параметр был недопустим. Существует несколько возможных причин:

Параметр не был дополнительным, но указателем был NULL.

Ссылочный номер объема, содержавший в FSRef не соответствует в настоящее время монтируемый объем. Если объем был размонтирован после, это может произойти FSRef создавался.

Некоторое другое частное поле в FSRef содержит значение, которое никогда не могло быть допустимо. Если значение поля могло бы быть допустимым, но, оказывается, не соответствует существующий объем или структуры данных в памяти, “не найденная” ошибка была бы возвращена вместо этого.

Доступный в OS X v10.0 и позже.
errFSBadForkName

Значение

- 1402

Описание

Предоставленное имя ветвления было недопустимо (т.е. было синтаксически недопустимо для данного объема). Например, имя ветвления могло бы содержать символы, которые не могут быть сохранены на данном объеме (таком как двоеточие на объемах HFS).

Некоторые форматы объема не хранят имена ветвления в Unicode. Эти форматы объема попытаются преобразовать имя Unicode к виду кодирования используемого форматом объема. Если имя не могло бы быть преобразовано, errFSBadForkName возвращается.

Некоторый объем форматирует, только поддерживают ограниченный набор ветвлений, таких как ветви данных и ветви ресурсов на объемах HFS. Для тех объемов, если какое-либо другое имя ветвления передается, возвращается эта ошибка.

Доступный в OS X v10.0 и позже.
errFSBadBuffer

Обязательный буферный указатель был NULL , или его размер был недопустим для типа данных, которые он, как ожидали, будет содержать. В защищенной системе памяти это могло также означать, что пространство буфера не является частью адресного пространства для обработки вызовов.

Значение

- 1403

Описание

Обязательный буферный указатель был NULL , или его размер был недопустим для типа данных, которые он, как ожидали, будет содержать. В защищенной системе памяти это могло также означать, что пространство буфера не является частью адресного пространства для обработки вызовов.

Доступный в OS X v10.0 и позже.
errFSBadForkRef

Значение

- 1404

Описание

Число ссылки на файл не соответствует ветвлению, открытому с FSOpenFork, PBOpenForkSync , или PBOpenForkAsync функции. Это могло быть то, потому что было уже закрыто то ветвление. Или, Вы, возможно, передали ссылочный номер, создаваемый с более старым APIs (например, PBHOpenDF функции). Значение нуля никогда не является ссылочным номером правильного файла.

Доступный в OS X v10.0 и позже.
errFSBadInfoBitmap

Значение

- 1405

Описание

A FSCatalogInfoBitmap или FSVolumeInfoBitmap имеет один или несколько зарезервированный или неопределенный набор битов. Если определенный бит установлен, но соответствие, этот код ошибки может также быть возвращен FSCatalogInfo или FSVolumeInfo на поле нельзя управлять с тем вызовом (например, пытаясь использовать FSSetCatalogInfo установить валентность каталога).

Доступный в OS X v10.0 и позже.
errFSMissingCatInfo

Значение

- 1406

Описание

A FSCatalogInfo указатель NULL , но не является дополнительным. Или, FSCatalogInfo является дополнительным и NULL, но соответствие FSCatalogInfoBitmap не нуль (т.е. битовый массив говорит что один или больше FSCatalogInfo поля передаются, но предоставленный указатель был NULL).

Доступный в OS X v10.0 и позже.
errFSNotAFolder

Значение

- 1407

Описание

Параметр, как ожидали, идентифицирует папку, но он идентифицировал некоторый другой вид объекта (например, файл) вместо этого. Это подразумевает, что указанный объект существует, но имеет неправильный тип. Например, один из параметров к FSCreateFileUnicode FSRef из каталога, где будет создаваться файл; если FSRef фактически относится к файлу, эта ошибка возвращается.

Доступный в OS X v10.0 и позже.
errFSForkNotFound

Попытка указать ветвление данного файла или каталога, но что не существует определенное ветвление.

Значение

- 1409

Описание

Попытка указать ветвление данного файла или каталога, но что не существует определенное ветвление.

Доступный в OS X v10.0 и позже.
errFSNameTooLong

Имя файла или ветвления было слишком длинным. Это означает, что никогда не могло существовать имя; это отличается от “файла, не найденного” или errFSForkNotFound ошибка.

Значение

- 1410

Описание

Имя файла или ветвления было слишком длинным. Это означает, что никогда не могло существовать имя; это отличается от “файла, не найденного” или errFSForkNotFound ошибка.

Доступный в OS X v10.0 и позже.
errFSMissingName

Требуемый параметр имени файла или ветвления был a NULL указатель или длина имени файла был нулем.

Значение

- 1411

Описание

Требуемый параметр имени файла или ветвления был a NULL указатель или длина имени файла был нулем.

Доступный в OS X v10.0 и позже.
errFSBadPosMode

Зарезервированные или недопустимые биты в a positionMode поле было установлено. Например, FSReadFork вызов не поддерживает режим новой строки, таким образом устанавливание новой строки укусило или символ новой строки в positionMode параметр вызвал бы эту ошибку.

Значение

- 1412

Описание

Зарезервированные или недопустимые биты в a positionMode поле было установлено. Например, FSReadFork вызов не поддерживает режим новой строки, таким образом устанавливание новой строки укусило или символ новой строки в positionMode параметр вызвал бы эту ошибку.

Доступный в OS X v10.0 и позже.
errFSBadAllocFlags

Зарезервированные или недопустимые биты были установлены в FSAllocationFlags параметр.

Значение

- 1413

Описание

Зарезервированные или недопустимые биты были установлены в FSAllocationFlags параметр.

Доступный в OS X v10.0 и позже.
errFSNoMoreItems

Больше нет элементов для возврата при перечислении каталога или поиске объема. Обратите внимание на то, что FSCatalogSearch возвраты эта ошибка, тогда как PBCatSearch функции возвратились бы eofErr.

Значение

- 1417

Описание

Больше нет элементов для возврата при перечислении каталога или поиске объема. Обратите внимание на то, что FSCatalogSearch возвраты эта ошибка, тогда как PBCatSearch функции возвратились бы eofErr.

Доступный в OS X v10.0 и позже.
errFSBadItemCount

maximumObjects параметр к FSGetCatalogInfoBulk или FSCatalogSearch был нуль.

Значение

- 1418

Описание

maximumObjects параметр к FSGetCatalogInfoBulk или FSCatalogSearch был нуль.

Доступный в OS X v10.0 и позже.
errFSBadSearchParams

Критерии поиска к FSCatalogSearch недопустимы или противоречивы.

Значение

- 1419

Описание

Критерии поиска к FSCatalogSearch недопустимы или противоречивы.

Доступный в OS X v10.0 и позже.
errFSRefsDifferent

Значение

- 1420

Описание

Два FSRef структуры передали FSCompareFSRefs для различных файлов или каталогов. Обратите внимание на то, что формат объема может быть в состоянии выдержать сравнение FSRef структуры, не ища файлы или каталоги, таким образом, эта ошибка может быть возвращена даже если один или оба из FSRef структуры относятся к несуществующим объектам.

Доступный в OS X v10.0 и позже.
errFSForkExists

Попытка создать ветвление, но то ветвление уже существует.

Значение

- 1421

Описание

Попытка создать ветвление, но то ветвление уже существует.

Доступный в OS X v10.0 и позже.
errFSBadIteratorFlags

Флаги передали FSOpenIterator недопустимы.

Значение

- 1422

Описание

Флаги передали FSOpenIterator недопустимы.

Доступный в OS X v10.0 и позже.
errFSIteratorNotFound

Значение FSIterator параметр не соответствует никакому в настоящее время открытому итератору.

Значение

- 1423

Описание

Значение FSIterator параметр не соответствует никакому в настоящее время открытому итератору.

Доступный в OS X v10.0 и позже.
errFSIteratorNotSupported

Значение

- 1424

Описание

Флаги итератора или контейнер FSIterator не поддерживаются тем вызовом. Например, в первоначальной версии, FSCatalogSearch вызывают, только поддерживает итератор, контейнер которого находится в корневом каталоге объема и чьи флаги являются kFSIterateSubtree (т.е. итератор для содержания всего объема). Точно так же в первоначальной версии, FSGetCatalogInfoBulk только поддерживает итератор, флаги которого являются kFSIterateFlat.

Доступный в OS X v10.0 и позже.
errFSQuotaExceeded

Квота пользователя дисковых блоков была исчерпана.

Значение

- 1425

Описание

Квота пользователя дисковых блоков была исчерпана.

Доступный в OS X v10.2 и позже.
afpAccessDenied

Значение

- 5000

Описание

У пользователя нет корректного доступа к файлу

Каталог не может быть совместно использован

Доступный в OS X v10.0 и позже.
afpAuthContinue

Дополнительная информация, запрошенная для завершения вызова AFPLogin.

Значение

- 5001

Описание

Дополнительная информация, запрошенная для завершения вызова AFPLogin.

Доступный в OS X v10.0 и позже.
afpBadUAM

Метод аутентификации пользователей неизвестен.

Значение

- 5002

Описание

Метод аутентификации пользователей неизвестен.

Доступный в OS X v10.0 и позже.
afpBadVersNum

Рабочая станция использует версию AFP, которую не распознает сервер.

Значение

- 5003

Описание

Рабочая станция использует версию AFP, которую не распознает сервер.

Доступный в OS X v10.0 и позже.
afpBitmapErr

Битовый массив содержал биты, неопределенные для вызова.

Значение

- 5004

Описание

Битовый массив содержал биты, неопределенные для вызова.

Доступный в OS X v10.0 и позже.
afpCantMove

Переместитесь место назначения является потомками источника, или корень был указан.

Значение

- 5005

Описание

Переместитесь место назначения является потомками источника, или корень был указан.

Доступный в OS X v10.0 и позже.
afpDenyConflict

Разрешение запрошенного пользователя, не возможное.

Значение

- 5006

Описание

Разрешение запрошенного пользователя, не возможное.

Доступный в OS X v10.0 и позже.
afpDirNotEmpty

Не удалить непустой каталог.

Значение

- 5007

Описание

Не удалить непустой каталог.

Доступный в OS X v10.0 и позже.
afpDiskFull

Недостаточное свободное пространство на объеме для работы.

Значение

- 5008

Описание

Недостаточное свободное пространство на объеме для работы.

Доступный в OS X v10.0 и позже.
afpEofError

Читайте вне логического конца файла.

Значение

- 5009

Описание

Читайте вне логического конца файла.

Доступный в OS X v10.0 и позже.
afpFileBusy

Не удалить открытый файл.

Значение

- 5010

Описание

Не удалить открытый файл.

Доступный в OS X v10.0 и позже.
afpFlatVol

Не может создать каталог на указанном объеме.

Значение

- 5011

Описание

Не может создать каталог на указанном объеме.

Доступный в OS X v10.0 и позже.
afpItemNotFound

Имя неизвестного пользователя / идентификатор пользователя или пропускающий комментарий / запись APPL.

Значение

- 5012

Описание

Имя неизвестного пользователя / идентификатор пользователя или пропускающий комментарий / запись APPL.

Доступный в OS X v10.0 и позже.
afpLockErr

Некоторые или весь требуемый диапазон заблокированы другим пользователем.

Значение

- 5013

Описание

Некоторые или весь требуемый диапазон заблокированы другим пользователем.

Доступный в OS X v10.0 и позже.
afpMiscErr

Неожиданная ошибка встретилась во время выполнения.

Значение

- 5014

Описание

Неожиданная ошибка встретилась во время выполнения.

Доступный в OS X v10.0 и позже.
afpNoMoreLocks

Больше диапазонов не может быть заблокировано.

Значение

- 5015

Описание

Больше диапазонов не может быть заблокировано.

Доступный в OS X v10.0 и позже.
afpNoServer

Сервер не отвечает.

Значение

- 5016

Описание

Сервер не отвечает.

Доступный в OS X v10.0 и позже.
afpObjectExists

Указанный целевой файл или каталог уже существует.

Значение

- 5017

Описание

Указанный целевой файл или каталог уже существует.

Доступный в OS X v10.0 и позже.
afpObjectNotFound

Указанный файл или каталог не существует.

Значение

- 5018

Описание

Указанный файл или каталог не существует.

Доступный в OS X v10.0 и позже.
afpParmErr

Указанный параметр был вне допустимого диапазона.

Значение

- 5019

Описание

Указанный параметр был вне допустимого диапазона.

Доступный в OS X v10.0 и позже.
afpRangeNotLocked

Указанный диапазон не был заблокирован.

Значение

- 5020

Описание

Указанный диапазон не был заблокирован.

Доступный в OS X v10.0 и позже.
afpRangeOverlap

Часть диапазона уже заблокирована.

Значение

- 5021

Описание

Часть диапазона уже заблокирована.

Доступный в OS X v10.0 и позже.
afpSessClosed

Сеанс закрылся.

Значение

- 5022

Описание

Сеанс закрылся.

Доступный в OS X v10.0 и позже.
afpUserNotAuth

Неработающая аутентификация пользователя (обычно, пароль не корректен).

Значение

- 5023

Описание

Неработающая аутентификация пользователя (обычно, пароль не корректен).

Доступный в OS X v10.0 и позже.
afpCallNotSupported

Неподдерживаемый вызов AFP был выполнен.

Значение

- 5024

Описание

Неподдерживаемый вызов AFP был выполнен.

Доступный в OS X v10.0 и позже.
afpObjectTypeErr

Значение

- 5025

Описание

Каталог существует с тем именем

Каталог, не найденный

Блокировка папки, не поддерживаемая объемом

Объект был файлом, не каталогом

Доступный в OS X v10.0 и позже.
afpTooManyFilesOpen

Максимальное открытое количество файла достигло.

Значение

- 5026

Описание

Максимальное открытое количество файла достигло.

Доступный в OS X v10.0 и позже.
afpServerGoingDown

Сервер закрывается.

Значение

- 5027

Описание

Сервер закрывается.

Доступный в OS X v10.0 и позже.
afpCantRename

AFPRename не может переименовать объем.

Значение

- 5028

Описание

AFPRename не может переименовать объем.

Доступный в OS X v10.0 и позже.
afpDirNotFound

Неизвестный каталог указан.

Значение

- 5029

Описание

Неизвестный каталог указан.

Доступный в OS X v10.0 и позже.
afpIconTypeError

Указанный размер значков отличается от существующего размера значков.

Значение

- 5030

Описание

Указанный размер значков отличается от существующего размера значков.

Доступный в OS X v10.0 и позже.
afpVolLocked

Объем только для чтения.

Значение

- 5031

Описание

Объем только для чтения.

Доступный в OS X v10.0 и позже.
afpObjectLocked

Объект является запрещенным M/R/D/W.

Значение

- 5032

Описание

Объект является запрещенным M/R/D/W.

Доступный в OS X v10.0 и позже.
afpContainsSharedErr

Каталог содержит точку доли.

Значение

- 5033

Описание

Каталог содержит точку доли.

Доступный в OS X v10.0 и позже.
afpIDNotFound

Идентификатор файла, не найденный.

Значение

- 5034

Описание

Идентификатор файла, не найденный.

Доступный в OS X v10.0 и позже.
afpIDExists

Идентификатор файла уже существует.

Значение

- 5035

Описание

Идентификатор файла уже существует.

Доступный в OS X v10.0 и позже.
afpDiffVolErr

Значение

- 5036

Описание

Доступный в OS X v10.0 и позже.
afpCatalogChanged

Каталог изменился, и поиск не может быть возобновлен.

Значение

- 5037

Описание

Каталог изменился, и поиск не может быть возобновлен.

Доступный в OS X v10.0 и позже.
afpSameObjectErr

Источник и целевые файлы являются тем же.

Значение

- 5038

Описание

Источник и целевые файлы являются тем же.

Доступный в OS X v10.0 и позже.
afpBadIDErr

Идентификатор файла, не найденный.

Значение

- 5039

Описание

Идентификатор файла, не найденный.

Доступный в OS X v10.0 и позже.
afpPwdSameErr

Кто-то попытался изменить их пароль на тот же пароль на обязательном изменении пароля.

Значение

- 5040

Описание

Кто-то попытался изменить их пароль на тот же пароль на обязательном изменении пароля.

Доступный в OS X v10.0 и позже.
afpPwdTooShortErr

Устанавливаемый пароль слишком короток: существует минимальная длина, которая должна быть встречена или превышена.

Значение

- 5041

Описание

Устанавливаемый пароль слишком короток: существует минимальная длина, которая должна быть встречена или превышена.

Доступный в OS X v10.0 и позже.
afpPwdExpiredErr

Пароль истек на сервере.

Значение

- 5042

Описание

Пароль истек на сервере.

Доступный в OS X v10.0 и позже.
afpInsideSharedErr

Каталог в общем каталоге.

Значение

- 5043

Описание

Каталог в общем каталоге.

Доступный в OS X v10.0 и позже.
afpInsideTrashErr

Совместно используемой папкой является в папке «Удаленные» OR, совместно используемая папка перемещается в папку «Удаленные».

Значение

- 5044

Описание

Совместно используемой папкой является в папке «Удаленные» OR, совместно используемая папка перемещается в папку «Удаленные».

Доступный в OS X v10.0 и позже.
afpPwdNeedsChangeErr

Пароль должен быть изменен.

Значение

- 5045

Описание

Пароль должен быть изменен.

Доступный в OS X v10.0 и позже.
afpPwdPolicyErr

Пароль не соответствует политике паролей сервера.

Значение

- 5046

Описание

Пароль не соответствует политике паролей сервера.

Доступный в OS X v10.0 и позже.
afpAlreadyLoggedInErr

Пользователь аутентифицировался, но уже зарегистрирован от другой машины (и это не позволяется на этом сервере).

Значение

- 5047

Описание

Пользователь аутентифицировался, но уже зарегистрирован от другой машины (и это не позволяется на этом сервере).

Доступный в OS X v10.0 и позже.
afpCallNotAllowed

Значение

- 5048

Описание

Доступный в OS X v10.0 и позже.
afpBadDirIDType

Не фиксированный объем каталога ID.

Значение

- 5060

Описание

Не фиксированный объем каталога ID.

Доступный в OS X v10.0 и позже.
afpCantMountMoreSrvre

Максимальное количество объемов было смонтировано.

Значение

- 5061

Описание

Максимальное количество объемов было смонтировано.

Доступный в OS X v10.0 и позже.
afpAlreadyMounted

Объем уже смонтировался.

Значение

- 5062

Описание

Объем уже смонтировался.

Доступный в OS X v10.0 и позже.
afpSameNodeErr

Попытайтесь войти в систему сервера, работающего на той же машине.

Значение

- 5063

Описание

Попытайтесь войти в систему сервера, работающего на той же машине.

Доступный в OS X v10.0 и позже.