NWDSSplitPartition

Divides a partition into two partitions at a specified object.

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)  NWDSSplitPartition  ( 
     NWDSContextHandle   context,  
     pnstr8              subordinatePartition,  
     nflag32             flags);

Pascal

  uses netwin32 
   
  Function NWDSSplitPartition 
    (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 object where the partition will be split and which will become the root of the subordinate partition.
flags: (IN) Reserved; pass in 0.

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

Operations to split a partition are always performed on the master replica. If the context handle points to a read-write or read-only replica, the request is redirected to the master replica.

The object specified becomes the root object of the subordinate partition.

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