NWDSGetPartitionInfo

Retrieves replica information from a result buffer filled by NWDSListPartitions.

NetWare Server:4.x, 5.x, 6.x

Platform:NLM, Windows NT, Windows 95, Windows 98, Windows 2000, Windows XP

Library:Cross-Platform NDS (NET*.*)

Service:NDS

Syntax

C

  #include <nwnet.h> 
  or 
  #include <nwdsbuft.h> 
   
  N_EXTERN_LIBRARY (NWDSCCODE)  NWDSGetPartitionInfo  ( 
     NWDSContextHandle   context,  
     pBuf_T              buf,  
     pnstr8              partitionName,  
     pnuint32            replicaType);

Pascal

  uses netwin32 
   
  Function NWDSGetPartitionInfo 
    (context : NWDSContextHandle; 
     buf : pBuf_T; 
     partitionName : pnstr8; 
     replicaType : pnuint32 
  ) : NWDSCCODE;

Parameters

context: (IN) Specifies the NDS 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 (see Section 5.23, Replica Types).

Return Values

0x0000 0000	SUCCESSFUL
nonzero value	Nonzero values indicate errors. See NDS Return Values (–001 to –799).

Remarks

The buf parameter points to a Buf_T filled by NWDSListPartitions.

The partitionName parameter 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 Unicode characters (Unicode characters are always 16 bits). One character is used for NULL termination.

The replicaType parameter points to NWREPLICA_TYPE containing information about the type of replica the partition is. The replica types are enumerated in NWDSDEFS.H (for a description, see Section 5.23, Replica Types).

For the complete steps for retrieving partition information, see Listing Partitions and Retrieving Partition Information.

NCP Calls

None