NWDSRepairTimeStamps

Sets the time stamps for all of a partition’s objects and their attributes to the current time on the NetWare server where the master replica is located.

Local Servers:blocking
Remote Servers:blocking
NetWare Server:4.x, 5.x, 6.x
Platform:NLM, Windows NT, Windows 95, Windows 98, Windows 2000, Windows XP
Library:Cross-Platform NDS (NET*.*)
Service:NDS

Syntax

C

  #include <nwnet.h> 
  or 
  #include <nwdsmisc.h> 
   
  N_EXTERN_LIBRARY (NWDSCCODE)  NWDSRepairTimeStamps  ( 
     NWDSContextHandle   context,  
     pnstr8              partitionRoot);

Pascal

  uses netwin32 
   
  Function NWDSRepairTimeStamps 
    (context : NWDSContextHandle; 
     partitionRoot : pnstr8 
  ) : NWDSCCODE;

Parameters

context

(IN) Specifies the NDS context for the request.

partitionRoot

(IN) Points to the name of the partition’s root object.

Return Values

These are common return values.

0x0000 0000

SUCCESSFUL

0x8996

SERVER_OUT_OF_MEMORY

0x89E2

TOO_FEW_FRAGMENTS

0x89E3

TOO_MANY_FRAGMENTS

0x89E4

PROTOCOL_VIOLATION

0x89E5

SIZE_LIMIT_EXCEEDED

0x89FD

UNKNOWN_REQUEST

0x89FD

INVALID_PACKET_LENGTH

0x89FE

BAD_PACKET

0x89FF

Failure not related to eDirectory

nonzero value

Nonzero values indicate errors. See NDS Return Values (–001 to –799).

Remarks

NWDSRepairTimeStamps sets the time stamps on all of the objects and their attributes, even if valid time stamps exist. It will replace information such as the creation dates of the attributes.

After NWDSRepairTimeStamps is called, eDirectory will synchronize all replicas to match the information in the master replica.

IMPORTANT:Because of the wide scope of changes made by NWDSRepairTimeStamps, it should be used only to recover from a catastrophic failure.

One concern with using NWDSRepairTimeStamps is that it can result in the loss of information. For example, any changes that have been made on replicas other than the master replica will be lost if they have not been synchronized with the master replica before NWDSRepairTimeStamps is called.

Another concern is with applications that use eDirectory Event Notification Services. After NWDSRepairTimeStamps is called, eDirectory will produce event notifications for every object and attribute on the master replica. It will also provide the same notification each time one of the other replicas is synchronized with the master replica.

NCP Calls