NWNSGetDefaultNS

Returns the default 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 NWNSGetDefaultNS ( 
      NWCONN_HANDLE       conn,  
      NWDIR_HANDLE        dirHandle,  
      const nstr8 N_FAR  *path,  
      pnuint8             pbuDefaultNameSpace);

Delphi Syntax

   uses calwin32 
    
   Function NWNSGetDefaultNS 
     (conn : NWCONN_HANDLE; 
      dirHandle : NWDIR_HANDLE; 
      const path : pnstr8; 
      pbuDefaultNameSpace : pnuint8 
   ) : NWCCODE;

Parameters

conn

(IN) Specifies the NetWare server connection handle.

dirHandle

(IN) Specifies the directory handle associated with the directory for which to return the default name space.

path

(IN) Points to a valid NetWare path (pointing to a directory or a file).

pbuDefaultNameSpace

(OUT) Points to the default name space.

Return Values

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

0x0000

SUCCESSFUL

0x8801

INVALID_CONNECTION

0x8836

INVALID_PARAMETER

0x890A

NLM_INVALID_CONNECTION

0x8996

SERVER_OUT_OF_MEMORY

0x8998

VOLUME_DOES_NOT_EXIST

0x89FF

BAD_DIRECTORY_HANDLE

0x899C

INVALID_PATH

Remarks

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.

NCP Calls

See Also

NWGetVolumeInfoWithHandle, NWGetVolumeNumber (Volume Management)