Прочитать на английском

Поделиться через


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

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

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

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

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

 
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

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