NWDSJoinPartitions

Joins a subordinate partition to its parent 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)  NWDSJoinPartitions  ( 
     NWDSContextHandle   context,  
     pnstr8              subordinatePartition,  
     nflag32             flags); 
  

Pascal

  uses netwin32 
   
  Function NWDSJoinPartitions 
    (context : NWDSContextHandle; 
     subordinatePartition : pnstr8; 
     flags : nflag32 
  ) : NWDSCCODE;
  

Parameters

context

(IN) Specifies the NDS context for the request.

subordinatePartition

(IN) Points to the name of the subordinate partition to be joined.

flags

Reserved; pass in NULL.

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

For partitions to be joined, a single replica (Master) of both the parent and subordinate partitions must exist. In addition, the master replicas must exist on the same server.

NCP Calls

See Also

NWDSAddReplica, NWDSChangeReplicaType, NWDSSplitPartition