NWGetDirectoryBaseExt

Retrieves information used in further calls to the name space

Local Servers:blocking
Remote Servers:blocking
NetWare Server:6.5 SP2 or later
Platform:NLM, Windows 2000, Windows XP
Client:4.90 SP2 or later
Library:Cross-Platform NetWare Calls (CAL*.*)
Service:Name Space

Syntax

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

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). The characters in the string must be UTF-8.

dstNamSpc

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

idxStruct

(OUT) Returns a filled in NW_IDX structure.

Return Values

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

0x0000

SUCCESSFUL

0x8801

INVALID_CONNECTION

0x88F0

UTF8_CONVERSION_FAILED

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

NWGetDirectoryBase