Returns information about the replicas of partitions stored on the specified server.
#include <nwnet.h> or #include <nwdspart.h> N_EXTERN_LIBRARY (NWDSCCODE) NWDSListPartitions ( NWDSContextHandle context, pnint_ptr iterationHandle, pnstr8 server, pBuf_T partitions);
uses netwin32 Function NWDSListPartitions ( context : NWDSContextHandle; iterationHandle : pnint_ptr; server : pnstr8; partitions : pBuf_T ) : NWDSCCODE;
(IN) Specifies the NDS context for the request.
(IN/OUT) Points to information needed to resume subsequent iterations of the operation.
(IN) Points to the server name whose list of partitions is requested.
(OUT) Points to a result buffer that receives the name and replica type for each partition stored on the specified server.
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 |
The iterationHandle parameter controls retrieval of results larger than the result buffer pointed to by subordinates.
Before the initial call to NWDSListPartitions, set the contents of the iteration handle pointed to by iterationHandle to NO_MORE_ITERATIONS.
If the result buffer holds the complete results when NWDSListPartitions returns from its initial call,, the location pointed to by iterationHandle is NO_MORE_ITERATIONS. If the iteration handle is not NO_MORE_ITERATIONS, use the iteration handle for subsequent calls to NWDSListPartitions to obtain further portions of the results. When the results are completely retrieved, the contents of the iteration handle will be NO_MORE_ITERATIONS.
To end the list operation before the complete results have been retrieved, call NWDSCloseIteration with a value of DSV_LIST_PARTITIONS to free memory and states associated with the list operation.
For more information, see Listing Partitions and Retrieving Partition Information.