NCS_FindVirtualServer

Finds a virtual server given a volume name.

Syntax

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

Parameters

Handle

(IN) Specifies the handle supplied by NCS.

VolName

(IN) Points to the case sensitive name of the server volume.

pPool

(OUT) Points to the filled in structure with virtual server FDN and IP address, if found.

Return Values

Name

Description

SUCCESS

NCS_SUCCESS.

FAILURE

See NDS Error Codes.

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_ALLOC_ERROR

Insufficient memory.

Remarks

Returns the virtual server FDN, resource FDN and name, and pool FDN in the pool structure. Also returns the IP address in the pool structure. The input parameter is assumed to be 64 bytes long.