Автономные файлы

Обзор технологии автономных файлов.

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

• cscapi.h
• cscobj.h

Рекомендации по программированию для этой технологии см. в следующих разделах:

• Автономные файлы

Перечисления

OFFLINEFILES_CACHING_MODE Описывает режим кэширования, используемый в таких методах, как IOfflineFilesCache::IsPathCacheable и IOfflineFilesShareInfo::GetShareCachingMode.
OFFLINEFILES_COMPARE Указывает тип сравнения, выполняемого в методе IOfflineFilesItemFilter::GetTimeFilter.
OFFLINEFILES_CONNECT_STATE Описывает состояние подключения элемента в кэше автономных файлов.
OFFLINEFILES_EVENTS Коды идентификаторов событий, описывающие события, которые будут получены или исключены приемником событий.
OFFLINEFILES_ITEM_COPY Указывает, запрашивается ли локальная, удаленная или исходная копия элемента.
OFFLINEFILES_ITEM_TIME Указывает, какое значение времени, связанное с элементом кэша, будет использоваться.
OFFLINEFILES_ITEM_TYPE Определяет тип элемента в кэше автономных файлов.
OFFLINEFILES_OFFLINE_REASON Указывает причину, по которой элемент находится в автономном режиме.
OFFLINEFILES_OP_RESPONSE Указывает, следует ли продолжить, повторить или остановить обработку элементов.
OFFLINEFILES_PATHFILTER_MATCH Указывает, насколько точно событие должно соответствовать фильтру.
OFFLINEFILES_SETTING_VALUE_TYPE Определяет тип данных, возвращаемый методом IOfflineFilesSetting::GetValueType.
OFFLINEFILES_SYNC_CONFLICT_RESOLVE Определяет код разрешения конфликтов, возвращаемый методом IOfflineFilesSyncConflictHandler::ResolveConflict.
OFFLINEFILES_SYNC_OPERATION Указывает тип операции синхронизации, выполняемой при обнаружении ошибки синхронизации.
OFFLINEFILES_SYNC_STATE Описывает состояние синхронизации элемента автономных файлов.

Функции

BackgroundSyncBegin Сообщает, что служба автономных файлов начинает выполнять этап фоновой синхронизации.
BackgroundSyncEnd Сообщает, что служба автономных файлов завершила прохождение фоновой синхронизации.
Начать Сообщает о начале операции.
CacheEvictBegin Этот метод зарезервирован для использования в будущем. (IOfflineFilesEvents2.CacheEvictBegin)
CacheEvictEnd Этот метод зарезервирован для использования в будущем. (IOfflineFilesEvents2.CacheEvictEnd)
CacheIsCorrupted Этот метод зарезервирован для использования в будущем. (IOfflineFilesEvents.CacheIsCorrupted)
CacheIsFull Этот метод зарезервирован для использования в будущем. (IOfflineFilesEvents.CacheIsFull)
CacheMoved Этот метод зарезервирован для использования в будущем. (IOfflineFilesEvents.CacheMoved)
Clone Создает новый экземпляр перечислителя с тем же состоянием перечисления, что и текущий. (IEnumOfflineFilesItems.Clone)
Clone Создает новый экземпляр перечислителя с тем же состоянием перечисления, что и текущий. (IEnumOfflineFilesSettings.Clone)
DataLost Сообщает, что одно или несколько событий, предназначенных для этого приемника событий, были потеряны и не будут доставлены.
DeleteItems Удаляет файлы и каталоги из локального кэша.
DeleteItemsForUser Удаляет файлы и каталоги пользователя из локального кэша.
DeletePreference Удаляет параметр предпочтения.
Enabled Этот метод зарезервирован для использования в будущем. (IOfflineFilesEvents.Enabled)
Encrypt Шифрует или расшифровывает содержимое кэша автономных файлов, кэшированного для вызывающего пользователя.
EncryptionChanged Этот метод зарезервирован для использования в будущем. (IOfflineFilesEvents.EncryptionChanged)
END Сообщает о завершении операции.
EnumItems Возвращает перечислитель дочерних элементов для элемента кэша, реализующего этот метод. (IOfflineFilesItemContainer.EnumItems)
EnumItemsEx Возвращает перечислитель дочерних элементов для элемента кэша, реализующего этот метод. (IOfflineFilesItemContainer.EnumItemsEx)
EnumSettingObjects Создает перечислитель экземпляров IOfflineFilesSetting.
Finditem Находит определенный файл или элемент каталога в кэше. (IOfflineFilesCache.FindItem)
FindItemEx Находит определенный файл или элемент каталога в кэше. (IOfflineFilesCache.FindItemEx)
GetAttributes Извлекает атрибуты Win32 для элемента.
GetConnectState Определяет, находится ли элемент в сети или в автономном режиме, а если он находится в автономном режиме, то почему.
GetDescription Извлекает текстовую строку, описывающую ошибку.
GetDiskSpaceInformation Извлекает объем дискового пространства, используемого кэшем автономных файлов, а также ограничения, применяемые к использованию кэша.
GetEncryptionStatus Извлекает текущее состояние шифрования (зашифрованное или незашифрованное) кэша автономных файлов.
GetExcludedEvents Извлекает массив значений перечисления OFFLINEFILES_EVENTS, описывающих, какие события не должны быть получены приемником событий.
GetFileAttributes Извлекает атрибуты файла Win32 для элемента.
GetFileSize Извлекает размер элемента.
GetFileSize Извлекает размер элемента в байтах.
GetFileTimes Извлекает время последней записи и изменения элемента.
GetFilterFlags Предоставляет флаги для управления фильтрацией элементов на основе флагов.
GetIncludedEvents Извлекает массив значений перечисления OFFLINEFILES_EVENTS, описывающих, какие события должны быть получены приемником событий.
GetItemChangeFlags Извлекает значение, содержащее набор флагов, описывающих изменения, возникшие во время операции синхронизации, связанной с ошибкой синхронизации.
GetItemType Возвращает код типа, определяющий тип элемента:_server, общего ресурса, каталога или файла.
GetLocalInfo Извлекает экземпляр интерфейса IOfflineFilesSyncErrorItemInfo, содержащий время файла, размер и атрибуты локальной копии элемента, участвующего в синхронизации.
GetLocation Извлекает текущий полный путь к каталогу кэша автономных файлов.
GetName Извлекает имя, связанное с определенным параметром автономных файлов.
GetOriginalInfo Извлекает экземпляр интерфейса IOfflineFilesSyncErrorItemInfo, содержащий время, размер и атрибуты исходной копии элемента, участвующего в синхронизации.
GetParentItem Извлекает интерфейс IOfflineFilesItem для родительского элемента.
GetPath Извлекает полную строку UNC-пути для элемента в кэше автономных файлов.
GetPathFilter Извлекает строку пути UNC и индикатор область, описывающий, какие события на основе пути должны быть доставлены в этот приемник событий.
GetPatternFilter Предоставляет строку шаблона фильтра для ограничения перечисляемых элементов на основе шаблонов имен элементов.
GetPolicy Извлекает политику, связанную с определенным параметром автономных файлов.
GetPolicyScope Извлекает область политики, связанной с этим параметром.
GetPreference Извлекает предпочтения для каждого компьютера или пользователя, связанные с определенным параметром автономных файлов.
GetPreferenceScope Указывает область предпочтения, связанного с этим параметром.
GetRawData Извлекает блок байтов, содержащий внутренние данные, связанные с ошибкой.
GetRemoteInfo Извлекает экземпляр интерфейса IOfflineFilesSyncErrorItemInfo, содержащий время, размер и атрибуты удаленной копии элемента, участвующего в синхронизации.
GetSettingObject Создает объект , представляющий определенный параметр автономных файлов.
GetShareCachingMode Извлекает конфигурацию режима кэширования ближайшей к элементу общей папки-предка.
GetShareItem Находит элемент кэша, представляющий ближайший к элементу общий ресурс-предок.
GetSyncOperation Извлекает значение, указывающее тип операции синхронизации, выполняемой при обнаружении ошибки.
GetTimeFilter Предоставляет семантику сравнения значений времени для управления фильтрацией элементов по времени.
GetTimes Извлекает значения времени, связанные с элементом.
GetValue Извлекает значение определенного параметра автономных файлов.
GetValueType Извлекает тип данных определенного параметра автономных файлов.
InfoAvailable Указывает, была ли получена информация для локальной, удаленной или исходной копии элемента во время синхронизации.
InfoEnumerated Указывает, была ли запрошена информация для локальной, удаленной или исходной копии элемента во время синхронизации.
IsCreatedOffline Определяет, был ли элемент создан в кэше автономных файлов во время работы в автономном режиме.
IsDeletedOffline Определяет, был ли элемент удален из кэша автономных файлов во время работы в автономном режиме.
IsDirty Определяет, был ли изменен элемент в кэше автономных файлов.
IsEncrypted Определяет, шифруется ли элемент в кэше автономных файлов.
IsGhosted Определяет, является ли элемент фантомным.
IsLocallyModifiedAttributes Определяет, были ли изменены один или несколько атрибутов элемента во время работы в автономном режиме.
IsLocallyModifiedData Определяет, были ли изменены данные элемента во время работы в автономном режиме.
IsLocallyModifiedTime Определяет, были ли изменены значения времени элемента во время работы в автономном режиме.
IsMarkedForDeletion Определяет, был ли элемент удален из кэша автономных файлов.
IsPartlyPinned Определяет, является ли элемент частично закрепленным.
IsPathCacheable Определяет, находится ли указанный UNC-путь в кэше автономных файлов.
IsPinned Определяет, закреплен ли элемент.
IsPinnedForComputer Определяет, был ли элемент закреплен для всех пользователей на компьютере с помощью групповая политика.
IsPinnedForFolderRedirection Определяет, закреплен ли элемент с помощью перенаправления папок.
IsPinnedForUser Определяет, был ли элемент закреплен пользователем.
IsPinnedForUserByPolicy Определяет, закреплен ли элемент для пользователей групповая политика.
IsShareDfsJunction Определяет, является ли элемент общего ресурса соединением DFS или общей папкой на сервере.
IsSparse Определяет, является ли элемент кэша автономных файлов разреженным.
IsSuspended Определяет, приостановлен ли элемент.
IsTransparentlyCached Определяет, является ли элемент прозрачно кэшируемым.
ItemAddedToCache Сообщает, что элемент был добавлен в кэш автономных файлов.
ItemAvailableOffline Сообщает, что элемент в кэше автономных файлов теперь доступен для автономного использования, если удаленная копия станет недоступной.
ItemBegin Сообщает, что операция с элементом начинается.
ItemDeletedFromCache Сообщает, что элемент был удален из кэша автономных файлов.
ItemDisconnected Сообщает, что элемент в кэше автономных файлов переключился из сети в автономный режим.
ItemModified Сообщает, что элемент в кэше автономных файлов был изменен.
ItemNotAvailableOffline Сообщает, что элемент в кэше автономных файлов больше недоступен для автономного использования, если удаленная копия станет недоступной.
ItemNotPinned Сообщает, что элемент в кэше автономных файлов больше не закреплен.
ItemPinned Сообщает, что элемент в кэше автономных файлов теперь закреплен и гарантированно будет доступен в автономном режиме, если удаленная копия станет недоступной.
ItemReconnectBegin Сообщает, что служба автономных файлов начинает пытаться повторно подключить все автономные области.
ItemReconnected Сообщает, что элемент в кэше автономных файлов переключился из автономного режима в режим "в сети".
ItemReconnectEnd Сообщает, что служба автономных файлов завершила попытку повторно подключить все автономные области.
ItemRenamed Сообщает, что путь к элементу в кэше автономных файлов переименован.
ItemResult Сообщает, что элемент был обработан во время операции.
LocalDirtyByteCount Извлекает объем несинхронизированных данных ("грязное") для связанного файла в локальном кэше автономных файлов.
NetTransportArrived Сообщает, что функция автономных файлов обнаружила поступление сетевого транспорта.
Вперед Извлекает следующий элемент перечисления и перемещает перечислитель. (IEnumOfflineFilesItems.Next)
Вперед Извлекает следующий элемент перечисления и перемещает перечислитель. (IEnumOfflineFilesSettings.Next)
NoNetTransports Сообщает, что функция автономных файлов обнаружила, что сетевые транспорты недоступны.
OfflineFilesEnable Включает или отключает функцию автономных файлов.
OfflineFilesQueryStatus Определяет, включена ли функция автономных файлов и, если да, активна ли она.
OfflineFilesQueryStatusEx Определяет, включена ли функция автономных файлов и, если да, является ли она активной и доступной. Эта функция идентична функции OfflineFilesQueryStatus, за исключением того, что у нее есть дополнительный выходной параметр.
OfflineFilesStart Запускает службу автономных файлов.
Pin Закрепляет файлы, каталоги и сетевые общие папки.
Проверка связи Это событие периодически доставляется всем зарегистрированным подписчикам событий.
PolicyChangeDetected Сообщает, что служба автономных файлов обнаружила изменение одного или нескольких значений параметров, которые управляются групповая политика.
PreferenceChangeDetected Сообщает, что служба автономных файлов обнаружила изменение одного или нескольких значений параметров, которые не контролируются групповая политика.
PrefetchFileBegin Сообщает о начале операции предварительной выборки файлов.
PrefetchFileEnd Сообщает, что операция предварительной выборки файла завершена.
ProcessAdminPinPolicy Заставляет автономные файлы обрабатывать групповую политику "автономные файлы, назначенные администратором".
QueryAbort Может вызываться во время длительных операций, чтобы определить, следует ли отменить операцию.
Обновить Обновляет все данные, кэшированные в объекте, путем повторного чтения из кэша автономных файлов.
RemoteDirtyByteCount Этот метод зарезервирован для использования в будущем. (IOfflineFilesDirtyInfo.RemoteDirtyByteCount)
RenameItem Переименовывает элемент в кэше.
RenameItemEx Переименовывает элемент в кэше. Этот метод идентичен методу IOfflineFilesCache::RenameItem, за исключением того, что он пытается выполнить операцию переименования сразу.
Сброс Сбрасывает последовательность в начало. (IEnumOfflineFilesItems.Reset)
Сброс Сбрасывает последовательность в начало. (IEnumOfflineFilesSettings.Reset)
ResolveConflict Предоставляет решение о разрешении конфликта синхронизации.
SetConnectState Задает состояние подключения для элемента.
SetDiskSpaceLimits Задает ограничения на использование дискового пространства в кэше автономных файлов.
SetPreference Задает параметры для компьютера или пользователя, связанные с параметром автономных файлов.
SettingsChangesApplied Сообщает, что служба автономных файлов применила изменения, обнаруженные в групповая политика или значениях предпочтения.
Skip Пропускает следующее указанное число элементов в перечислении. (IEnumOfflineFilesItems.Skip)
Skip Пропускает следующее указанное число элементов в перечислении. (IEnumOfflineFilesSettings.Skip)
SuspendRoot Приостановка или освобождение корневого каталога общего ресурса или дерева каталогов.
SyncBegin Сообщает, что кэш автономных файлов начал операцию синхронизации.
SyncConflictRecAdded Сообщает, что конфликт синхронизации обнаружен и записан в журнале конфликтов синхронизации.
SyncConflictRecRemoved Сообщает, что конфликт синхронизации больше не существует и что его запись была удалена из журнала конфликтов синхронизации.
SyncConflictRecUpdated Сообщает о обнаружении конфликта синхронизации и о том, что запись о конфликте уже присутствует в журнале конфликтов синхронизации.
SyncEnd Сообщает, что кэш автономных файлов завершил операцию синхронизации.
SyncFileResult Сообщает результат синхронизации определенного файла.
Synchronize Синхронизирует файлы и каталоги в кэше автономных файлов с соответствующими копиями в соответствующих общих сетевых папках.
SyncItemBegin Сообщает о начале операции синхронизации с элементом.
SyncItemResult Сообщает, что элемент был обработан во время операции синхронизации.
TransitionOffline По возможности переводит элемент в автономный режим.
TransitionOnline По возможности переводит элемент в режим "в сети".
TransparentCacheItemNotify Сообщает, что действие было выполнено с прозрачным кэшируемым элементом.
Открепить Открепить файлы, каталоги и сетевые общие папки из кэша автономных файлов.

Интерфейсы

IEnumOfflineFilesItems Представляет коллекцию указателей интерфейса IOfflineFilesItem.
IEnumOfflineFilesSettings Перечисляет объекты параметров, связанные со службой автономных файлов.
IOfflineFilesCache Используется для управления кэшем автономных файлов.
IOfflineFilesCache2 Реализует метод RenameItemEx.
IOfflineFilesChangeInfo Представляет сведения, связанные с локальными изменениями, внесенными в элемент во время работы в автономном режиме.
IOfflineFilesConnectionInfo Представляет возможности запросов и действий, связанные с поведением перехода автономных файлов в режиме "в сети".
IOfflineFilesDirectoryItem Представляет элемент каталога в кэше автономных файлов.
IOfflineFilesDirtyInfo Представляет сведения о несинхронизированном (грязное) файле в кэше автономных файлов.
IOfflineFilesErrorInfo Предоставляет текстовое описание и необработанный блок данных, связанный с ошибкой.
IOfflineFilesEvents Используется для сообщения о важных событиях, связанных с автономными файлами.
IOfflineFilesEvents2 Используется для создания отчетов о дополнительных событиях, связанных с автономными файлами.
IOfflineFilesEvents3 Используется для создания отчетов о событиях, связанных с прозрачно кэшируемыми элементами.
IOfflineFilesEventsFilter Предоставляет получателям опубликованных событий механизм ограничения числа получаемых ими экземпляров событий.
IOfflineFilesFileItem Представляет элемент файла в кэше автономных файлов.
IOfflineFilesFileSysInfo Представляет стандартные сведения, связанные с элементом файловой системы в кэше автономных файлов.
IOfflineFilesGhostInfo Представляет фантомное состояние элемента в кэше автономных файлов.
IOfflineFilesItem Представляет один элемент в кэше автономных файлов.
IOfflineFilesItemContainer Используется для доступа к функциям перечисления элементов в кэше автономных файлов.
IOfflineFilesItemFilter Представляет экземпляр фильтра, применяемого к перечислению.
IOfflineFilesPinInfo Представляет закрепленное состояние элемента в кэше автономных файлов.
IOfflineFilesPinInfo2 Определяет метод для определения того, частично ли закреплен элемент в кэше автономных файлов.
IOfflineFilesProgress Используется для передачи отчетов о ходе выполнения вызывающим абонентам длительных операций с автономными файлами. (IOfflineFilesProgress)
IOfflineFilesServerItem Представляет элемент сервера в кэше автономных файлов.
IOfflineFilesSetting Представляет параметр, который управляет поведением службы автономных файлов.
IOfflineFilesShareInfo Предоставляет сведения о кэшированных элементах, относящиеся к общей папке.
IOfflineFilesShareItem Представляет элемент общей папки в кэше автономных файлов.
IOfflineFilesSimpleProgress Используется для передачи отчетов о ходе выполнения вызывающим абонентам длительных операций с автономными файлами. (IOfflineFilesSimpleProgress)
IOfflineFilesSuspend Приостанавливает или освобождает корневой каталог общего ресурса или дерево каталогов в кэше автономных файлов.
IOfflineFilesSuspendInfo Определяет, приостановлен ли элемент или нет, и, если да, является ли он приостановленным корневым каталогом.
IOfflineFilesSyncConflictHandler Используется клиентом, вызывающим метод IOfflineFilesCache::Synchronize, чтобы назначить стратегию разрешения конфликтов для конфликтов синхронизации по мере их обнаружения.
IOfflineFilesSyncErrorInfo Поставляется с методом IOfflineFilesSyncProgress::SyncItemResult для передачи сведений об элементе, который столкнулся с ошибкой синхронизации.
IOfflineFilesSyncErrorItemInfo Предоставляет атрибуты файла, сведения о времени и размер файла для элемента, связанного с ошибкой синхронизации.
IOfflineFilesSyncProgress Используется для передачи данных о ходе выполнения вызывающей стороне во время синхронизации и операций, связанных с синхронизацией.
IOfflineFilesTransparentCacheInfo Представляет сведения, связанные с прозрачно кэшируемыми элементами.