Returns extended information about the replicas stored on the specified server.
#include <nwnet.h> or #include <nwdspart.h> N_GLOBAL_LIBRARY (NWDSCCODE) NWDSListPartitionsExtInfo ( NWDSContextHandle context, pnint_ptr iterationHandle, pnstr8 server, nflag32 DSPFlags, pBuf_T partitions);
uses netwin32 Function NWDSListPartitionsExtInfo (context : NWDSContextHandle; iterationHandle : pnint_ptr; server : pnstr8; DSPFlags : nflag32 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.
(IN) Points to the DSP information flags (see Section 5.20, DSP Replica Information Flags).
(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 NWDSListPartitionsExtInfo, set the contents of the iteration handle pointed to by iterationHandle to NO_MORE_ITERATIONS.
If the result buffer holds the complete results when NWDSListPartitionsExtInfo 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 NWDSListPartitionsExtInfo 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.