Platform SDK: Network Management

REPL_INFO_0

The REPL_INFO_0 structure contains configuration information for the file replicator service, including import and export paths and other replication parameters.

typedef struct _REPL_INFO_0 {
  DWORD          rp0_role;
  LPWSTR         rp0_exportpath;
  LPWSTR         rp0_exportlist;
  LPWSTR         rp0_importpath;
  LPWSTR         rp0_importlist;
  LPWSTR         rp0_logonusername;
  DWORD          rp0_interval;
  DWORD          rp0_pulse;
  DWORD          rp0_guardtime;
  DWORD          rp0_random;
} REPL_INFO_0, *PREPL_INFO_0, *LPREPL_INFO_0;

Members

rp0_role
Specifies either one or both of the following values.Value Meaning
REPL_ROLE_EXPORT Exports directory control information.
REPL_ROLE_IMPORT Imports directory control information on a Windows NT/Windows 2000 workstation.

rp0_exportpath
Specifies the root directory that holds the exportpath parameter.
rp0_exportlist
Specifies the list of computers or domains to export, using semicolon delimiters. If the list is empty, the function uses the local domain.
rp0_importpath
Specifies the root directory that holds the importpath parameter. If both the export tree and import tree are on an NTFS partition, the file replicator service copies the file permissions as well as the files themselves.
rp0_importlist
Specifies the list of computers or domains to import, using semicolon delimiters. If the list is empty, the function uses the local domain.
rp0_logonusername
Specifies the account the file replicator service attempts to use if the user is not logged on.
rp0_interval
Specifies the interval, in minutes, that elapses between the times the exporter contacts each import server for changes in each top-level directory.

The exporter sends a sync message if it detects a change to the directory since the last contact, or a pulse message if it detects no change. The default setting is 5 minutes.

rp0_pulse
Specifies a multiplier for synchronization of the importer and exporter. The default setting is 2.

If the exporter fails to respond to an importer after the number of minutes obtained by multiplying rp0_pulse times rp0_interval, the importer sends a message to the exporter asking for an update. If the exporter fails to respond again (after the same amount of time) the importer reports that the top-level directory is not synchronized. If the exporter fails to respond a third time, the importer no longer notifies the exporter.

The importer resumes notifying the exporter when the exporter responds and replication is successful.

rp0_guardtime
Specifies the period of time, in minutes (by default), that each file and directory within the replicated directory must be stable before the file replicator service sends a synchronizing message with an updated checksum.

This setting is valid only for top-level directories when the wait-until-stabilized feature is enabled. The value of rp0_guardtime cannot be more than rp0_interval divided by 2.

rp0_random
Specifies the maximum time, in seconds, that import servers wait before requesting an update from the exporter. The default value is 60. You may want to increase this value substantially if you increase rp0_interval to 60 or more minutes. The maximum value is 120.

Import servers generate a random number of seconds, from 0 to the value of rp0_random. After receiving an update notice from the exporter, the import server waits the generated amount of seconds before requesting the replica from the export server. This can prevent the export server from being overloaded with simultaneous update requests.

Requirements

  Windows NT/2000: Requires Windows NT 4.0 or earlier.
  Windows 95/98: Unsupported.
  Header: Declared in Lmrepl.h.

See Also

Network Management Overview, Network Management Structures, Replicator Functions, NetReplGetInfo, NetReplSetInfo