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:

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

  2. Set the iteration handle to NO_MORE_ITERATIONS.

  3. Obtain the partition information by calling NWDSListPartitions.

  4. Determine the number of partitions whose information is stored in the request buffer by calling NWDSGetServerName.

  5. For each partition whose information is stored in the buffer, retrieve the partition information by calling NWDSGetPartitionInfo.

  6. If the iteration handle is set to NO_MORE_ITERATIONS, go to step 7; otherwise, loop to step 3.

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