NetReplSetInfo

The NetReplSetInfo function modifies the file replicator service configuration information.

Security Requirements

Only members of the Administrators or Account Operators local group can successfully execute the NetReplSetInfo function.

NET_API_STATUS NetReplSetInfo(
  LPCWSTR servername, 
  DWORD level,        
  const LPBYTE buf,   
  LPDWORD parm_err    
);

Parameters

servername

[in] Pointer to a constant null-terminated Unicode string specifying the name of the remote server on which the function is to execute. The string must begin with \\. If this parameter is NULL, the local computer is used.

level

[in] Specifies the information level of the data. This parameter can be one of the following values.

Value	Meaning
0	Specifies configuration information for the file replicator service. The buf parameter points to a REPL_INFO_0 structure.
1000	Specifies the interval that elapses between the times the exporter contacts each import server for changes in each top-level directory. The buf parameter points to a REPL_INFO_1000 structure.
1001	Specifies a count that the file replicator service uses to synchronize the importer and the exporter. The buf parameter points to a REPL_INFO_1001 structure.
1002	Specifies the time that each file and directory must be stable before the file replicator service updates the client. The buf parameter points to a REPL_INFO_1002 structure.
1003	Specifies the maximum time the importer waits before requesting an update from the exporter. The buf parameter points to a REPL_INFO_1003 structure.

buf

[in] Pointer to the buffer that specifies the data. The format of this data depends on the value of the level parameter.

parm_err

[out] Pointer to a DWORD value that receives the index of the first parameter that caused the ERROR_INVALID_PARAMETER error. If this parameter is NULL, the index is not returned on error.

Return Values

If the function succeeds, the return value is NERR_Success.

If the function fails, the return value is a Win32 API error code. For a list of error codes, see Error Codes.

Remarks

You can call the NetReplGetInfo function to retrieve configuration information for the file replicator service.

Requirements

  Windows NT/2000: Requires Windows NT 4.0 or earlier.
  Windows 95/98: Unsupported.
  Header: Declared in Lmrepl.h; include Lm.h.
  Library: Use Netapi32.lib.

See Also

Network Management Overview, Network Management Functions, Replicator Functions, NetReplGetInfo, REPL_INFO_0, REPL_INFO_1000, REPL_INFO_1001, REPL_INFO_1002, REPL_INFO_1003