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.