NWNSGetMiscInfo

Retrieves information to be 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 NWNSGetMiscInfo ( 
      NWCONN_HANDLE       conn,  
      nuint8              dirHandle,  
      const nstr8 N_FAR  *path,  
      nuint8              dstNameSpace,  
      NW_IDX N_FAR       *idxStruct);
   

Delphi Syntax

   uses calwin32 
    
   Function NWNSGetMiscInfo 
     (conn : NWCONN_HANDLE; 
      dirHandle : nuint8; 
      const path : pnstr8; 
      dstNameSpace : 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 NetWare path (pointing to a directory or a file).

dstNameSpace

(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

dirHandle / path should match dstNameSpace.

Both the dirHandle and path parameters must be in the default name space.

The default name space is the name space that matches the OS and the loaded name spaces on that volume. For example, Windows 95 on a volume with LONG name space will set LONG name space as the default name space.

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

NCP Calls

See Also

NWGetDirectoryBase