Windows Vista. Для профессионалов — страница 138 из 143

Класс Win32_OfflineFilesChangelnfo

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

• CreatedOffline, тип: boolean – разрешено ли создавать автономный файл, если сетевой доступ к оригинальной копии автономного файла отсутствует;

• DeletedOffline, тип: boolean – разрешено ли удалять автономный файл, если сетевой доступ к оригинальной копии автономного файла отсутствует;

• Dirty, тип: boolean – была ли изменена копия автономного файла, пока доступ к ее оригиналу отсутствовал;

• ModifiedAttributes, тип: boolean – разрешено ли изменять автономный файл, если сетевой доступ к оригинальной копии автономного файла отсутствует;

• Modif iedData, тип: boolean – было ли изменено содержимое копии автономного файла, пока доступ к ее оригиналу отсутствовал;

• Modif iedTime, тип: boolean – была ли изменена временная метка копии автономного файла, пока доступ к ее оригиналу отсутствовал.

Класс Win32_OfflineFilesConnectionlnfo

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

• ConnectState, тип: uint32 – сетевого подключения к оригиналу данного автономного файла; возможны следующие значения данного свойства: неизвестно, сетевое подключение отсутствует и работа ведется с копией файла, сетевое подключение установлено и работа ведется с оригиналом автономного файла.

• OfflineReason, тип: uint32 – доступа к автономным файлам; возможны следующие значения данного свойства: неизвестно, значение свойства не применимо, работа в автономном режиме, работа по медленному соединению, сетевое подключение отсутствует, необходима синхронизация, элемент приостановлен.

Класс Win32_OfflineFilesSuspendlnfo

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

• Suspended, тип: boolean – определяет, приостановлена ли синхронизация элемента в данный момент.

• SuspendedRoot, тип: boolean – указывает, приостановлено ли дерево элементов.

Класс Win32_OfflineFilesProgress

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

• CallbackReason, тип: uint32 – определяет, поддерживает ли автономный файл обратный вызов. Возможные значения: Progress и SyncConflictResolution.

• ProgressReason, тип: uint32 – указывает текущее состояние связи с оригиналом автономного файла. Возможные значения данного свойства: начало, окончание, элемент начала, элемент окончания.

• Result, тип: uint32 – определяет код результата операции синхронизации.

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

Класс Win32_OfflineFilesSimpleProgress

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

• CallbackReason, тип: uint32 – указывает, поддерживает ли автономный файл обратный вызов. Возможные значения: Progress и SyncConf lictResolution.

• ProgressReason, тип: uint32 – определяет текущее состояние связи с оригиналом автономного файла. Возможные значения данного свойства: начало, окончание, элемент начала, элемент окончания.

• Result, тип: uint32 – указывает код результата операции синхронизации.

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

Класс Win32_OfflineFilesltem

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

• ChangeInfo, тип: указатель на объект Win32_OfflineChangeInfo – возвращает указатель на информацию элемента.

• ConnectionInfo, тип: указатель на объект Win32_OfflineConnectionInfo – хранит информацию о соединении элемента.

• FileSysInfо, тип: указатель на объект Win32_OfflineFilesFileSys Info – содержит информацию об элементе.

• ItemName, тип: string – хранит имя автономного файла без пути к нему.

• ItemPath, тип: string – является ключевым. Оно содержит путь к элементу.

• ItemType, тип: uint32 – определяет тип элемента. Возможны следующие типы: файл, каталог, общий ресурс, сервер.

• ParentltemPath, тип: string – возвращает путь к родительскому элементу. Если значение данного свойства равно NULL, то элемент является сервером.

• PinInfo, тип: указатель на объект Win32_OfflineFilesPinInfo – определяет информацию о синхронизации.

• SuspendInfo, тип: указатель на объект Win32_OfflineSuspendInfo – указывает информацию о приостановке элемента.

Класс Win32_OfflineFilesCache

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

• Active, тип: boolean – указывает, разрешены ли автономные файлы.

• Enabled, тип: boolean – определяет, разрешены ли автономные файлы.

• Location, тип: string – указывает путь к каталогу, содержащему автономные файлы.

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

• Deleteltems – удаляет один или несколько элементов из кэша автономного файла.

Входящие параметры:

• массив путей к файлам, имеющий тип string;

• флаги, имеющие тип uint32. Возвращаемые параметры: нет.

• Enable – включает или отключает использование автономных файлов.

Входящий параметр: флаг нового состояния механизма автономных файлов.

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

• Encrypt – включает или отключает возможность шифрования кэша автономных файлов.

Входящие параметры:

• флаг, определяющий, включено или нет шифрование, имеет тип boolean;

• флаги команды, имеют тип uint32. Возвращаемые параметры: нет.

• Pin – определяет, что элемент доступен в автономном режиме.

Входящие параметры:

• массив путей к файлам, имеющий тип string;

• флаги команды, имеют тип uint32;

• Deep – имеет тип boolean. Возвращаемые параметры: нет.

• Renameltem – изменяет путь к кэшу автономных файлов.

Входящие параметры:

• строковый параметр, определяющий оригинальный путь;

• строковый параметр, определяющий новый путь;

• параметр типа boolean, определяющий, будет ли происходить дублирование информации.

Возвращаемые параметры: нет.

• SuspendRoot – приостанавливает или нет путь к дереву каталогов кэша автономных файлов.

Входящие параметры:

• строковый параметр, определяющий путь к каталогу;

• параметр типа boolean, определяющий, будет ли приостановлено использование данного пути.

Возвращаемые параметры: нет.

• Synchronize – выполняет синхронизацию одного или нескольких файлов.

Входящие параметры:

• массив путей к файлам, которые нужно синхронизировать, имеющий тип string;

• флаги команды, имеют тип uint32.

Возвращаемые параметры: нет.

• Unpin – отменяет доступ к файлам в автономном режиме.

Входящие параметры:

• массив путей к файлам, имеющий тип string;

• флаги команды, имеют тип uint32;

• Deep – имеет тип boolean. Возвращаемые параметры: нет.

Групповые политики

Работу данного мастера можно ограничить с помощью групповых политик файла OfflineFiles. admx, расположенных в подразделе Конфигурация компьютера → Административные шаблоны → Сеть → Автономные файлы.

Данные политики изменяют значения следующих параметров REGDWORD-типа, расположенных в ветви реестра HKEY_LOCAL_MACHINE\SOFTWARE\Policies\ Microsoft\Windows\NetCache.

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

• CacheQuotaLimit – значение этого параметра определяет объем свободного пространства в мегабайтах, который будет использоваться для хранения автономных файлов. По умолчанию для хранения автономных файлов используется 25 % от объема диска.

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

• Enabled – если значение данного параметра равно 0, то использование автономных файлов будет запрещено.

• NoMakeAvailableOffline – при установке значения этого параметра равным 1 команда Сделать доступными автономно не будет отображаться в контекстном меню сетевых папок и файлов. Параметр можно также создавать в ветви реестра корневого раздела HKEY_CURRENT_USER.

• EconomicalAdminPinning – если значение данного параметра равно 1, то при входе пользователя в систему будет выполняться синхронизация только файлов и папок, назначенных для синхронизации администратором и еще недоступных в автономном режиме. Синхронизация файлов и папок, назначенных администратором и уже доступных в автономном режиме, будет выполняться позже. Список всех автономных файлов, назначенных для синхронизации администратором, хранится в виде параметров строкового типа ветви реестра HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Windows\NetCache\ AssignedOfflineFolders.

• SlowLinkEnabled – при установке значения этого параметра равным 1 будет включен режим обнаружения медленных подключений. При этом список компьютеров, для которых будет применяться этот режим, хранится в параметрах строкового типа ветви реестра HKEY_LOCAL_MACHINE\ SOFTWARE \ Pol icies\ Microsoft\Windows\NetCache\SlowLinkParams. Имя параметра данной ветви реестра определяет название компьютера. Значение же определяет параметры, по которым можно обнаружить, что на текущий момент используется медленное подключение. При обнаружении медленного режима все запросы к удаленным файлам будут перенаправляться в кэш автономных файлов компьютера.