NWDSAddReplica(3nw)


NWDSAddReplica -- adds a replica of an existing Directory partition to a server

Synopsis

   #include <nwnet.h> 
   or 
   #include <nwdspart.h> 
   

NWDSCCODE N_API NWDSAddReplica (NWDSContextHandle context, pnstr8 server, pnstr8 partitionRoot; nuint32 replicaType);

Description

The parameters are as follows:

context
(IN) Specifies the Directory context for the request.

server
(IN) Points to the name of the server where the replica is to be stored.

partitionRoot
(IN) Points to the name of the root object of the Directory partition to be replicated.

replicaType
(IN) Specifies the type of the new replica (secondary or read-only).

Return values

0x0000
SUCCESSFUL

Negative Value
Negative values indicate errors. For errors returned by Directory Services, see ``Directory Services OS Errors'' (-001 to -255), ``Directory Services Client Library Errors'' (-301 to -399), or ``Directory Services Agent in the Server Errors'' (-601 to -699).

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 Directory Services

Notices

The partition must be created beforehand by calling NWDSAddPartition or NWDSSplitPartition.

replicaType determines the type of replica to be created:

Value Constant Description
1 RT_SECONDARY Secondary
2 RT_READONLY Read-only

 
 ----------------------------------------------------- 
| Value|  Constant            |  Description         | 
|------|----------------------|----------------------| 
| 1    |  RT_SECONDARY        |  Secondary           | 
|------|----------------------|----------------------| 
| 2    |  RT_READONLY         |  Read-only           | 
|------|----------------------|----------------------| 


NOTE:

You cannot create a master replica type (RT_MASTER) with NWDSAddReplica.


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

Services

Directory

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 NDS NCP
0x2222 104 02 Send NDS Fragmented Request/Reply

References

NWDSAddPartition(3nw), NWDSChangeReplicaType(3nw), NWDSRemoveReplica(3nw)


30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.