NWDSRemoveReplica

Removes a replica from the replica set of an eDirectory partition.

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 <nwdspart.h> 
   
  N_EXTERN_LIBRARY (NWDSCCODE)  NWDSRemoveReplica  ( 
     NWDSContextHandle   context,  
     pnstr8              server,  
     pnstr8              partitionRoot);

Pascal

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

Parameters

context: (IN) Specifies the NDS context for the request.
server: (IN) Points to the server name where the replica is stored.
partitionRoot: (IN) Points to the name of the root object of the eDirectory partition whose replica is being deleted.

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
0x89FF	Failure not related to eDirectory
0x89FE	BAD_PACKET
nonzero value	Nonzero values indicate errors. See NDS Return Values (–001 to –799).

Remarks

NWDSRemoveReplica removes any replica except the master replica of a partition.

Remove the master replica by calling NWDSRemovePartition after all other replicas have been removed by calling NWDSRemoveReplica.

Aliases are never dereferenced by NWDSRemoveReplica. The setting of the NDS context flag associated with DCV_DEREF_ALIASES is not relevant and is ignored.

NCP Calls

0x2222 23 17 Get File Server Information
0x2222 23 22 Get Station’s Logged Info (old)
0x2222 23 28 Get Station’s Logged Info
0x2222 104 01 Ping for eDirectory NCP
0x2222 104 02 Send eDirectory Fragmented Request/Reply