DFSReturnVolumeMappingInformation

Returns information about a volume required for file allocation

Local Servers:nonblocking
Remote Servers:N/A
NetWare Server:4.x, 5.x, 6.x
Platform:NLM
Service:Direct File System

Syntax

  #include <nwdfs.h>  
   
  LONG DFSReturnVolumeMappingInformation  (  
     LONG                                 volumeNumber,   
     struct VolumeInformationStructure   *volumeInformation); 
  

Parameters

volumeNumber
(IN) Specifies the system volume number of the selected volume. A requesting process can determine the appropriate volume number using the File System Services functions.
volumeInformation
(OUT) Points to a structure of type VolumeInformationStructure (see below).

Return Values

Decimal

Constant

Description

0

DFSNormalCompletion

The operation is complete and information fields are valid.

152

DFSInvalidVolume

The volume number specified does not exist or is not mounted.

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. Application NLM applications must be designed to handle the likelihood that blocks available change dynamically.

See Also

DFSReturnFileMappingInformation, DFSReturnVolumeBlockInformation