На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

Replicator Functions



The replicator functions control how the Windows NT replicator service updates selective directories from an export server to one or more clients. In addition to providing compatible LAN Manager 2.x functionality in a well-defined manner, this new set of LAN Manager functions allow for specific API (operation) security checking. There are three categories of replicator functions:

· Replicator configuration functions
· Replicator export directory functions
· Replicator import directory functions



If you are unable to replicate files, before using the replicator functions, check the Control Panel Services application to make sure the replicator service is configured to log on using a specific user account. This user account must be a member of the Replicator local group, and it must not be disabled or lacking permission to access the import and export trees on the respective servers. Failure specify the user account is the most common error in configuring the Replicator service.

The Windows NT Replicator service is intended to copy relatively small directory trees. If you are attempting to replicate multimegabyte directory trees or trees containing thousands of directories and files, you should consider some other means of doing so.
The change from the file system based control on LAN Manager 2.x to replicator function control on Windows NT has the following implications:

· Applications can no longer delete a directory in the import path of a client to stop receiving updates from its master.
· Applications can no longer use the REPL.INI file in each replicated directory on a master to control the method of replication.
· Applications can no longer lock or unlock a directory on a master from being replicated by creating or deleting the USERLOCK.* file(s).
· Applications can no longer lock or unlock a directory on a client from receiving updates from its master by creating or deleting USERLOCK.* files.

· Applications that depend on the LAN Manager 2.x behavior of ignoring locks for file integrity trees will need to be modified. (Windows NT policy differs from LAN Manager 2.x policy; under Windows NT the locks are always respected.)



Each of the intended operations listed preceding can be specified to the Windows NT replicator service through an appropriate function.
Any user or application logged on as a member of the administration group or the server operator group on a local or remote export server can modify the parameters that control the replication service.

Replicator Configuration Functions

The configuration parameters of the replicator service can be examined and modified using the replicator configuration functions. The replicator configuration functions are:
NetReplGetInfo
NetReplSetInfo
The configuration parameters of the replictor can be examined using NetReplGetInfo. They can be modified using NetReplSetInfo.
The replicator configuration information structures are:
REPL_INFO_0
REPL_INFO_1000
REPL_INFO_1001
REPL_INFO_1002
REPL_INFO_1003

Replicator Export Directory Functions

The replicator export directory functions control top-level directories under the export path on the master. The replicator export directory functions are:
NetReplExportDirAdd
NetReplExportDirDel
NetReplExportDirEnum
NetReplExportDirGetInfo
NetReplExportDirLock
NetReplExportDirSetInfo
NetReplExportDirUnlock
A user can create a new directory under the export path and the Replicator service will automatically replicate that directory. Or, a directory under the export path can be registered using NetReplExportDirAdd. When adding a directory to be replicated using these functions, the replication controls (integrity and extent) are specified using the NetReplExportDirAdd function. If the directory is created in the file system and no replicator functions are called, then the directory is treated as having file integrity and tree extent.

The integrity control determines when a master updates a client. When integrity is REPL_INTEGRITY_FILE, the client gets a replica of a file within the directory when it is not in use (being changed or replicated). When integrity is set to REPL_INTEGRITY_TREE, every file and directory within the replicated directory must be stable for the amount of time specified by the guardtime parameter before the client is updated. The extent control determines whether the entire tree within the directory is replicated (REPL_EXTENT_TREE) or only the files in the first-level directory is replicated (REPL_EXTENT_FILE).

The replication controls of each replicated directory can be examined using NetReplExportDirGetInfo, and dynamically modified using NetReplExportDirSetInfo. These control fields used to be specified in the REPL.INI file within each replicated directory on LAN Manager 2.x, and they could not be dynamically set. On Windows NT, the REPL.INI file is not used and will be ignored in the replication process.
The NetReplExportDirEnum function returns a list of directories that are currently replicated. The NetReplExportDirDel function unregisters a directory so that it is no longer replicated.

The lock status information is returned in two fields: lockcount and locktime. The lockcount field indicates the number of outstanding locks on a directory. The locktime field indicates the time (in seconds since 1970, GMT) when the directory was first locked, or is 0 if the directory is not locked at the present time.
The NetReplExportDirLock function locks a directory so that it is not replicated, by incrementing a lock reference count for the directory. A lock on a directory can be unlocked using NetReplExportDirUnlock. The replication does not resume unless all outstanding locks on that directory are released, and the lock reference count is returned to 0. (The locktime field is automatically set to 0 when lockcount is 0.)

The replicator export directory functions can be called regardless of whether the Replicator service is running. If the Replicator service is running as a master, any modification to the directory controls takes effect immediately, and is persistent after the Replicator service has been stopped. If the Replicator service is not started, the controls for the directory is stored as persistent information and will take effect when the Replicator service starts up.
The replicator export directory functions are available at the following information levels:

REPL_EDIR_INFO_0
REPL_EDIR_INFO_1
REPL_EDIR_INFO_2
REPL_EDIR_INFO_1000
REPL_EDIR_INFO_1001

Replicator Import Directory Functions

The replicator import directory functions designate the top-level directories under the import path to receive updates on. They also return status information about a replicated directory on the client. On LAN Manager 2.x, a user must create a directory under the import path and the Replicator service automatically replicates to it. The replicator import directory functions are:
NetReplImportDirAdd
NetReplImportDirDel
NetReplImportDirEnum
NetReplImportDirGetInfo
NetReplImportDirLock
NetReplImportDirUnlock

On Windows NT, import directories are automatically added if they are exported by an export server from which importer is importing. Another way to register a directory in advance of it being exported, is to use the NetReplImportDirAdd functions. This function does not create the directory itself. This is useful if you wish to modify some of the properties of the import directory (for example, to lock it) prior to it first beginning to import this directory.

The NetReplImportDirDel function unregisters a directory. This is used to clean up a directory that is no longer being exported. It will not stop replication if there is an active exporter, since it will be re-registered the next time the exporter tells the importer what directories it is exporting. If you wish to prevent importing of an actively exported directory, use NetReplImportDirLock.
The NetReplImportDirEnum function lists all the directories that are replicated to a client, and NetReplImportDirGetInfo returns the status of a specified directory.

The status information of a directory consists of the replication state, the UNC computer name of the master (mastername), and the time (in seconds since 1970, GMT) when the directory was last updated (last_update_time). If the state is REPL_STATE_OK, the directory currently has a master, and is receiving regular update notices from it. If the state is REPL_STATE_NO_MASTER, the directory is not supported by any master, and it is typically empty. If the state is REPL_STATE_NO_SYNC, the directory has a master, but the master has not sent any update notices within the interval time period. This may be due to a communication failure, the master crashing, the directory being locked, files in the client directory being opened at update time, or an unstable REPL_INTEGRITY_TREE integrity directory on the master. If the client Replicator service is not started, the state is REPL_STATE_NEVER_REPLICATED, mastername is a NULL string, and last_update_time is 0. The NetReplImportDirLock function locks a directory so that it does not receive updates, by incrementing a lock reference count for the directory. A lock on a directory can be unlocked using NetReplImportDirUnlock. The directory is not updated unless all outstanding locks on that directory are released, and the lock reference count is returned to 0.

The lock status information is returned in two fields: lockcount and locktime. The lockcount field indicates the number of outstanding locks on a directory. The locktime field indicates the time (in seconds since 1970, GMT) when the directory was first locked. (locktime is set to 0 whenever lockcount goes to 0.)
The replicator import directory functions can be called whether the Replicator service is running or not. If the Replicator service is running as a client, directory adds or deletes take effect immediately, and is persistent after the Replicator service has been stopped. If the Replicator service is not started, any added directory will receive updates when the Replicator service starts up (if there exists a master that exports the directory).

The replicator import directory function are available at the following information levels:
REPL_IDIR_INFO_0
REPL_IDIR_INFO_1


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

Replicator Функционирует



replicator Функционирует управление как услуга replicator Windows NT корректирует выборочные директории от экспортного сервера до одного или более клиентов. Дополнительно к обеспечению совместимого 2.x функционального назначения Менеджера LAN в отчетливо выраженном способе, эта новая установка функций Менеджера LAN учитывает специфической API безопасности (операция) проверка. Есть три категории функций replicator:

Функции конфигурации Replicator экспортные функции директория Replicator импортные функции директория Replicator



Если Вы - не в состоянии скопировать файлы, прежде, чем использование replicator будет функционировать, проверить Панель Управления Услуг приложения, чтобы убеждаться что услуга replicator сконфигурирована, чтобы регистрироваться в использовании специфического счета пользователя. Этот счет пользователя должен быть элементом локальной группы Replicator, и это не должно вывожено из строя или недоставая разрешения иметь доступ к импорту и экспортировать деревья в соответствующие серверы. Неудача определяет что счет пользователя является наиболее общей ошибкой на выборе конфигурации услуга Replicator.

Услуга Windows NT Replicator собирается копировать сравнительно небольшие деревья директория. Если Вы пытаетесь копировать multimegabyte деревья директория или деревьев, содержащие тысячи директориев и файлов, Вы должны рассматривать некоторые другие средства занятия так.
Заменять с файловой системы основавшей управление на Менеджере LAN 2.x на функциональное управление replicator на Windows NT имеет следующий смысл:

Приложения не могут больше удалить директорий в импортном пути клиента, чтобы переставать получать коррекцию из своего мастера.
Приложения не могут больше использовать файл REPL.INI в каждом скопировавшее директорий на мастере, чтобы управлять методом копирования.
Приложения не могут больше запирать или деблокировать директорий на мастере из скопированное созданием или удаляя USERLOCK.* файл(файлы).
Приложения не могут больше запирать или деблокировать директорий на клиенте чтобы получать коррекцию из своего мастера создавая или удаляя USERLOCK.* файлы.

Приложения, которые зависят от 2.x поведения Менеджера LAN игнорирующей блокировки для файловых деревьев целостности должно быть модифицировано. (Полис Windows NT отличается от 2.x полиса Менеджера LAN; под Windows NT, блокировка всегда уважалась.)



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

Функции Конфигурации Replicator

Параметры конфигурации услуги replicator могут быть изучены и модифицированы используя функции конфигурации replicator. Функции конфигурации replicator:
NetReplGetInfo NetReplSetInfo
Параметры конфигурации replictor могут быть изучены используя NetReplGetInfo. Они могут быть модифицированы используя NetReplSetInfo.
Конфигурация replicator информационных структур:
REPL_INFO_0 REPL_INFO_1000 REPL_INFO_1001 REPL_INFO_1002 REPL_INFO_1003

Экспортный Директорий Replicator Функционирует

Экспортный директорий replicator функционирует управляющие директории верхнего уровня под экспортным путем на мастере. Функции экспортного директория replicator:
NetReplExportDirAdd NetReplExportDirDel NetReplExportDirEnum NetReplExportDirGetInfo NetReplExportDirLock NetReplExportDirSetInfo NetReplExportDirUnlock
Пользователь может создать новый директорий под экспортным путем и услуга Replicator автоматически скопирует этот директорий. Или, директорий под экспортным путем может быть зарегистрирован используя NetReplExportDirAdd. При дополнении директория, которое нужно копировать использование этих функций, элементы управления копирования (целостность и протяженность), определены используя функцию NetReplExportDirAdd. Если директорий создан в файловой системе и никакие функции replicator не названы, тогда директорий рассмотрен как иметь файловая протяженность целостности и дерева.

Управление целостностью определяется когда мастер корректирует клиента. Когда целостность - REPL_INTEGRITY_FILE, клиент получает копию файла в пределах директория когда он - не в использовании (измененное или скопированное). Когда целостность установлена на REPL_INTEGRITY_TREE, каждый файл и директорий в пределах скопированного директория должны быть стабильными для времени определенного параметром guardtime прежде, чем клиент будет скорректирован. Управление протяженности определяется независимо целое дерево в пределах директория скопирован (REPL_EXTENT_TREE) или только файлы в прямом директории скопированы (REPL_EXTENT_FILE).

Управление копирования каждым скопировавшее директорий может быть изучено используя NetReplExportDirGetInfo, и динамически модифицированное используя NetReplExportDirSetInfo. Эти управляют областями обычно определен в файле REPL.INI в пределах каждого скопировавшее директорий на Менеджере LAN 2.x, и они не могли динамически устанавливаны. На Windows NT, файл REPL.INI не использован и будет проигнорирован в процессе копирования.
Функция NetReplExportDirEnum возвращает список директориев, которые к настоящему времени скопированы. Функция NetReplExportDirDel unregisters директорий чтобы это больше не было копировано.

Информация статуса блокировки возвращана в две области: lockcount и locktime. Область lockcount указывает количество выдающейся блокировки в директории. Область locktime указывает время (в течение секунд с 1970, ПО ГРИНВ.) когда директорий сначала был заперт, или - 0 если директорий не заперт в настоящем времени.
Функция NetReplExportDirLock запирает директорий чтобы она не была скопирована, увеличивая ссылку блокировки иметь значение директорий. Блокировка в директории может быть деблокирована используя NetReplExportDirUnlock. Копирование не продолжается если вся выдающаяся блокировка в этом директории не выпущена, и счет ссылки блокировки возвращан на 0. ( Область locktime автоматически установлена на 0 когда lockcount - 0.)

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

REPL_EDIR_INFO_0 REPL_EDIR_INFO_1 REPL_EDIR_INFO_2 REPL_EDIR_INFO_1000 REPL_EDIR_INFO_1001

Импортный Директорий Replicator Функционирует

Функции импортного директория replicator определяют директории верхнего уровня под импортным путем, чтобы получать коррекцию на. Они также возвращают информацию статуса о скопированном директории на клиенте. На Менеджере LAN 2.x, пользователь должен создать директорий под импортным путем и услуга Replicator автоматически копируется этому. Функции импортного директория replicator:
NetReplImportDirAdd NetReplImportDirDel NetReplImportDirEnum NetReplImportDirGetInfo NetReplImportDirLock NetReplImportDirUnlock

На Windows NT, импортные директории автоматически добавлены если они экспортированы экспортным сервером из которого импортер импортируется. Другой путь регистрировать директорий заранее экспортируется, должен использовать функции NetReplImportDirAdd. Эта функция не создает сам директорий. Это полезное если Вы хотите модифицировать некоторые свойства импортного директория (например, чтобы запирать это) до этого сначала начиная, чтобы импортировать этот директорий.

Функция NetReplImportDirDel unregisters директорий. Это использован, чтобы наводить порядок директорий, который не больше не экспортированн. Это не остановит копирование если есть активный экспортер, поскольку это будет см.- зарегистрированным следующий раз экспортер сообщает импортеру какие директории это экспортируется. Если Вы хотите предохранять импорт активно экспортируемого директория, используйте NetReplImportDirLock.
Функция NetReplImportDirEnum включает все директории, которые скопированы клиенту, и NetReplImportDirGetInfo возвращает статус определенного директория.

Информация статуса директория состоит из состояния копирования, компьютерное имя UNC мастера (mastername), и время (в течение секунд с 1970, ПО ГРИНВ.) когда директорий последний раз был скорректирован (last_update_time). Если состояние - REPL_STATE_OK, директорий к настоящему времени имеет мастера и получает регулярные уведомления коррекции из этого. Если состояние - REPL_STATE_NO_MASTER, директорий не поддерживан любым мастером, и это обычно пустое. Если состояние - REPL_STATE_NO_SYNC, директорий имеет мастера, но мастер не послал любой коррекции уведомления в пределах периода времени интервала. Это может явиться следствием неудачи связи, основная авария, директорий, запиранные, файлы в директории клиента, открыванном во времени коррекции, или неустойчивом директории целостности REPL_INTEGRITY_TREE на мастере. Если услуга клиента Replicator не запущена, состояние - REPL_STATE_NEVER_REPLICATED, mastername - НЕДЕЙСТВИТЕЛЬНАЯ строка, и last_update_time - 0. Функция NetReplImportDirLock запирает директорий чтобы она не получала коррекцию, увеличивая ссылку блокировки иметь значение директорий. Блокировка в директории может быть деблокирована используя NetReplImportDirUnlock. Директорий не скорректирован если вся выдающаяся блокировка в этом директории не выпущена, и счет ссылки блокировки возвращан на 0.

Информация статуса блокировки возвращана в две области: lockcount и locktime. Область lockcount указывает количество выдающейся блокировки в директории. Область locktime указывает время (в течение секунд с 1970, ПО ГРИНВ.) когда директорий сначала был заперт. (locktime установлен на 0 всякий раз, когда lockcount идет на 0.)
Импортный директорий replicator функционирует может называться выполняет услуга Replicator или нет. Если услуга Replicator выполняет как клиент, директорий добавляет или удаляет вступать в силу немедленно, и устойчивый после того, как услуга Replicator будет прекратиться. Если услуга Replicator не запущена, любой дополнительный директорий получит коррекцию когда услуга Replicator запускает (если там существует мастера, который экспортирует директорий).

Функция импортного директория replicator доступна на следующих информационных уровнях:
REPL_IDIR_INFO_0 REPL_IDIR_INFO_1


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz