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.