NWGetDirectoryBase

Retrieves information used in further calls to the name space

Local Servers:blocking
Remote Servers:blocking
NetWare Server:3.11, 3.12, 3.2, 4.x, 5.x, 6.x
Platform:NLM, Windows NT, Windows 95, Windows 98
Library:Cross-Platform NetWare Calls (CAL*.*)
Service:Name Space

Syntax

   #include <nwnamspc.h> 
   or 
   #include <nwcalls.h> 
    
   NWCCODE N_API NWGetDirectoryBase ( 
      NWCONN_HANDLE       conn,  
      nuint8              dirHandle,  
      const nstr8 N_FAR  *path,  
      nuint8              dstNamSpc,  
      NW_IDX N_FAR       *idxStruct);
   

Delphi Syntax

   uses calwin32 
    
   Function NWGetDirectoryBase 
     (conn : NWCONN_HANDLE; 
      dirHandle : nuint8; 
      const path : pnstr8; 
      dstNamSpc : nuint8; 
      Var idxStruct : NW_IDX 
   ) : NWCCODE;
   

Parameters

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).

dstNamSpc

(IN) Specifies the destination name space (see Section 20.5, Name Space Flag Values).

idxStruct

(OUT) Points to NW_IDX.

Return Values

These are common return values; see Return Values (Return Values for C) for more information.

0x0000

SUCCESSFUL

0x8801

INVALID_CONNECTION

0x890A

NLM_INVALID_CONNECTION

0x8998

VOLUME_DOES_NOT_EXIST

0x899B

BAD_DIRECTORY_HANDLE

0x899C

INVALID_PATH

0x89BF

INVALID_NAME_SPACE

Remarks

The path parameter must be upper case if dirHandle contains a DOS name space directory handle.

The path and dirHandle parameters must match the dstNamSpc parameter.

NetWare uses the idxStruct parameter 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.

NCP Calls

See Also

NWNSGetMiscInfo, NWReadExtendedNSInfo, NWReadNSInfo , NWWriteExtendedNSInfo, NWWriteNSInfo