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.