Platform SDK: Network Management

REPL_IDIR_INFO_1

The REPL_IDIR_INFO_1 structure contains specifies subdirectories and synchronizing states in the main import directory of the replicator.

typedef struct _REPL_IDIR_INFO_1 {
  LPWSTR         rpid1_dirname;
  DWORD          rpid1_state;
  LPWSTR         rpid1_mastername;
  DWORD          rpid1_last_update_time;
  DWORD          rpid1_lockcount;
  DWORD          rpid1_locktime;
} REPL_IDIR_INFO_1, *PREPL_IDIR_INFO_1, *LPREPL_IDIR_INFO_1;

Members

rpid1_dirname
Specifies the name of a subdirectory in the main import directory.
rpid1_state
Specifies a DWORD value that contains a set of bit flags indicating the synchronization state of the import subdirectory. This member can be one of the following values.
Value Meaning
REPL_STATE_OK The directory currently has a master and is receiving regular update notices from it.
REPL_STATE_NO_MASTER The directory is not supported by any master and is typically empty.
REPL_STATE_NO_SYNC The directory has a master, but the master has not sent update notices within the specified time period. (The rp0_interval member specifies the time period.) For more information, see the following Remarks section.
REPL_STATE_NEVER_REPLICATED The file replicator service has not been started on the import server.

rpid1_mastername
Specifies the name of the exporter for the selected subdirectory. If the rpid1_state member is equal to REPL_STATE_NEVER_REPLICATED, this member is a NULL string.
rpid1_last_update_time
Specifies the time, in seconds since 00:00:00, January 1, 1970, GMT, when the selected directory was last updated. If the rpid1_state member is equal to REPL_STATE_NEVER_REPLICATED, this member is equal to 0.
rpid1_lockcount
Specifies the current lock count on the subdirectory. You can modify this member only with the NetReplImportDirLock and NetReplImportDirUnlock functions.
rpid1_locktime
Specifies the time at which the directory was locked, in seconds, since 00:00:00, January 1, 1970, GMT.

Remarks

When a master does not send updates, and the rpid1_state member is equal to REPL_STATE_NO_SYNC, it can be due to various reasons. These reasons include communication failure, the master crashing, a locked directory, open files on the import server at update time, or an unstable directory on the master.

To retrieve the interval (rp0_interval) that elapses between the times the exporter should contact each import server for changes, you can call the NetReplGetInfo function and specify information level REPL_INFO_0.

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, NetReplImportDirEnum, NetReplImportDirGetInfo, NetReplImportDirLock, NetReplImportDirUnlock