NWGetDirectoryBase(3nw)


NWGetDirectoryBase -- retrieves information used in further calls to the name space

Synopsis

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

NWCCODE N_API NWGetDirectoryBase (NWCONN_HANDLE conn, nuint8 dirHandle, pnstr8 path, nuint8 dstNamSpc, NW_IDX N_FAR * idxStruct);

Description

The parameters are as follows:

conn
(IN) Specifies the NetWare server connection handle.

dirHandle
(IN) Specifies the directory handle associated with the directory to search.

path
(IN) Points to a valid DOS path (pointing to a directory or a file). Must be lower case.

wdstNamSpc
(IN) Specifies the destination name space.

idxStruct
(OUT) Points to NW_IDX.

Return values

0x0000
SUCCESSFUL

0x8801
INVALID_CONNECTION

0x8998
VOLUME_DOES_NOT_EXIST

0x899B
BAD_DIRECTORY_HANDLE

0x899C
INVALID_PATH

0x89BF
INVALID_NAME_SPACE

Notices

path must be lower case for NWGetDirectoryBase to work properly.

path and dirHandle must match dstNamSpc.

NetWare uses idxStruct as an index to quickly locate a directory entry (file or directory). It is required as a calling parameter to other functions and should not be modified by the application.

Services

Name Space

NCP calls

0x2222 22 3
Get Directory Effective Rights

0x2222 22 19
Allocate Temporary Directory Handle

0x2222 22 20
Free Directory Handle

0x2222 23 15
Scan Files

0x2222 23 17
Get File Server Information

0x2222 68
File Erase

0x2222 87 2
Scan First

0x2222 87 3
Scan Next

0x2222 87 8
Delete Entry

0x2222 87 12
Allocate Directory Handle

0x2222 87 22
Generate Directory Base And Volume Number

References

NWWriteNSInfo(3nw), NWReadExtendedNSInfo(3nw), NWNSGetMiscInfo(3nw), NWWriteExtendedNSInfo(3nw), NWReadNSInfo(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.