NWDSGetPartitionInfo(3nw)


NWDSGetPartitionInfo -- retrieves replica information from result buffer

Synopsis

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

NWDSCCODE N_API NWDSGetPartitionInfo (NWDSContextHandle context, pBuf_T buf, pnstr8 partitionName, pnuint32 replicaType);

Description

The parameters are as follows:

context
(IN) Specifies the Directory context for the request.

buf
(IN) Points to the result buffer to be read.

partitionName
(OUT) Points to the name of the root object of a partition.

replicaType
(OUT) Points to the replica type.

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).

Notices

buf points to a Buf_T filled by NWDSListPartitions.

partitionName points to a memory location containing the distinguished name of a partition for which replica information has been found. You must allocate space for the partition name. The size of the allocated memory 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.

replicatype points to NWREPLICA_TYPE containing information about the type of replica the partition is. The replica types are enumerated in NWDSDEFS.H as follows:

RT_MASTER
Master Replica

RT_SECONDARY
Secondary Replica

RT_READ_ONLY
Read-only Replica

RT_SUBREF
Partition with only a root object

The complete steps for retrieving partition information are listed in the reference for NWDSListPartitions.

Services

Directory

NCP calls

None

References

NWDSGetServerName(3nw), NWDSListPartitions(3nw)


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