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.