NWDSGetPartitionRoot(3nw)


NWDSGetPartitionRoot -- returns the partition root name of the given object

Synopsis

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

NWDSCCODE N_API NWDSGetPartitionRoot (NWDSContextHandle context, pnstr8 objectName, pnstr8 partitionRoot);

Description

The parameters are as follows:

context
(IN) Specifies the Directory 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

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

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 double-byte characters (Unicode is double byte). One character is used for NULL termination.

Services

Directory


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