dfs_getvolmapinfo

Returns information about a volume, which can be used for file allocation.

Library:LibC
Classification:Novell
Service:Direct File System

Syntax

  #include <dfs.h>  
   
  int dfs_getvolmapinfo (
     int              volNum,
     dfs_volinfo_t   *volinfo );

Parameters

volNum

(IN) Specifies the system volume number of the selected volume. To discover the volumes on the local server, use netware_vol_info.

volinfo

(OUT) Points to a structure of type dfs_volinfo_t.

Return Values

If successful, returns 0. Otherwise, returns a nonzero error code:

Decimal

Constant

Description

79

ENOTSUP

The NLM is loaded in protected address space. This operation is supported only in kernel address space.

For possible DFS errors, see Section 13.4.5, DFS Return Values.

Remarks

This function provides volume information, including allocation block size, that is necessary to determine how many blocks to allocate in order to allocate a specified number of bytes for a request. This information changes dynamically. Therefore, it can become invalid before an application NLM can use the information. Applications must be designed to handle the likelihood that blocks available change dynamically.

See Also