NWDSGetPartitionRoot

Returns the partition root name of the given object.

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 <nwdsdsa.h> 
   
  N_EXTERN_LIBRARY (NWDSCCODE)  NWDSGetPartitionRoot  ( 
     NWDSContextHandle   context,  
     pnstr8              objectName,  
     pnstr8              partitionRoot);

Pascal

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

Parameters

context: (IN) Specifies the NDS context for the request.
objectName: (IN) Points to the object’s name.
partitionRoot: (OUT) Points to the partition root name. You must allocate memory for partitionRoot ; either MAX_DN_BYTES or MAX_DN_CHARS.

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

If the object is itself a partition root, partitionRoot is the same as the object name.

The caller must allocate space for partitionRoot. The size of the memory allocated is ((MAX_DN_CHARS)+1)*sizeof(character size), where character size is 1 for single-byte characters and 2 for Unicode characters (Unicode characters are always 16 bits). One character is used for NULL termination.