NWGetSparseFileBitMap(3nw)


NWGetSparseFileBitMap -- returns a bit map showing which blocks in a sparse file contain data

Synopsis

   #include <nwfile.h> 
   or 
   #include <nwcalls.h> 
   

NWCCODE N_API NWGetSparseFileBitMap (NWCONN_HANDLE conn, NWFILE_HANDLE fileHandle, nint16 flag, nuint32 offset, pnuint32 blockSize, pnuint8 bitMap);

Description

The parameters are as follows:

conn
(IN) Specifies the NetWare server connection handle. Use conn only when NETX is running or fileHandle contains a NetWare handle (otherwise ignored).

fileHandle
(IN) Specifies the OS or NetWare file handle. If a NetWare file handle is used, a connection handle must be passed.

flag
(IN) Specifies whether fileHandle contains an OS or NetWare handle. If flag equals 0, fileHandle contains an OS (DOS or OS/2) file handle. If flag is non-zero, fileHandle contains a 4-byte NetWare handle.

offset
(IN) Specifies the starting offset of bit map.

blockSize
(OUT) Points to the size of the allocation block.

bitMap
(OUT) Points to a 512-byte array to receive bit map. bitMap contains 1 bit for each block.

Return values

0x0000
SUCCESSFUL

0x8801
INVALID_CONNECTION

0x8988
INVALID_FILE_HANDLE

Notices

NWGetSparseFileBitMap contains one bit for each block in the sparse file. A one (1) indicates there is data in the block; a zero (0) indicates there isn't any data in the block.

bitMap MUST point to an array of 512 bytes.

Services

File Systems

NCP calls

0x2222 85
Get Sparse File Data Block Bit Map

30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.