NCS_WhatVolumes

Enumerates the volumes on a pool.

Platform:Not supported for NetWare 5.1.

Syntax

 #include <ncssdk.h> 
  
 NCS_RETURN NCS_WhatVolumes (
   NCS_HANDLE       Handle, 
   NCS_POOL_INFO   *pPool);
 

Parameters

Handle

(IN) Specifies the application’s handle.

pPool

(OUT) Points to a pool structure including the virtual server FDN and IP address if found.

Return Values

Name

Description

SUCCESS

NCS_SUCCESS.

NCS_ALLOC_ERROR

Insufficient memory to perform the operation.

NCS_BAD_PARAMETER

See NDS Error Codes.

NCS_NOT_SUPPORTED

Message returned when NCS_ClusterIPAddress is called in a cluster running on a platform version less than NetWare 6.

NCS_UNKNOWN

Unspecified error.

Remarks

You will not know what volumes are in a pool prior to calling NCS_WhatVolumes. One of the fields of the NCS_POOL_INFO input structure receives a list of the volumes returned. You must first use NCS_WherePools to enumerate the pools, then call NCS_WhatVolumes to enumerate the volumes on the pool you’re interested in.

The numVols field must be set and VOLUME_INFO must be large enough to hold numVols number of volumes.