NWDSListPartitions(3nw)
NWDSListPartitions --
returns information about the replicas of partitions stored on the specified server
Synopsis
#include <nwnet.h>
or
#include <nwdspart.h>
NWDSCCODE N_API NWDSListPartitions
(NWDSContextHandle context,
pnint32 iterationHandle,
pnstr8 server,
pBuf_T partitions);
Description
The parameters are as follows:
- context
-
(IN) Specifies the Directory context for the request.
- iterationHandle
-
(IN/OUT) Points to information needed to resume subsequent iterations of the operation.
- server
-
(IN) Points to the server name whose list of partitions is requested.
- partitions
-
(OUT) Points to a result buffer that receives the name and replica type for each partition stored on the specified server.
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
Partition information is retrieved by using the following steps:
-
Allocate a result buffer to receive the results by calling NWDSAllocBuf. (The buffer does not need to be initialized since it is a result buffer.)
-
Set the iteration handle to NO_MORE_ITERATIONS.
-
Obtain the partition information by calling NWDSListPartitions.
-
Determine the number of partitions whose information is stored in the request buffer by calling NWDSGetServerName.
-
For each partition whose information is stored in the buffer, retrieve the partition information by calling NWDSGetPartitionInfo.
-
If the iteration handle is set to NO_MORE_ITERATIONS, go to step 7; otherwise, loop to step 3.
-
Free the buffer when it is not longer needed by calling NWDSFreeBuf.
If you decide to stop retrieving partition information before
iterationHandle is set to NO_MORE_ITERATIONS, call
NWDSCloseIteration to free memory and state
information associated with the partition listing operation.
Services
Directory
NCP calls
- 0x2222 23 17
-
Get File Server Information
- 0x2222 23 22
-
Get Station's Logged Info (old)
- 0x2222 23 28
-
Get Station's Logged Info
- 0x2222 104 01
-
Ping for NDS NCP
- 0x2222 104 02
-
Send NDS Fragmented Request/Reply
References
NWDSGetServerName(3nw),
NWDSGetPartitionInfo(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.