NWGetLongName

Retrieves a filename for the specified 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 NWGetLongName ( 
      NWCONN_HANDLE       conn,  
      nuint8              dirHandle,  
      const nstr8 N_FAR  *path,  
      nuint8              srcNamSpc,  
      nuint8              dstNamSpc,  
      pnstr8              longName);
   

Delphi Syntax

   uses calwin32 
    
   Function NWGetLongName 
     (conn : NWCONN_HANDLE; 
      dirHandle : nuint8; 
      const path : pnstr8; 
      srcNamSpc : nuint8; 
      dstNamSpc : nuint8; 
      longName : pnstr8 
   ) : NWCCODE;
   

Parameters

conn

(IN) Specifies the NetWare server connection handle.

dirHandle

(IN) Specifies the directory handle associated with the directory to scan. It can be 0 if path contains a fully specified path.

path

(IN) Points to a valid path. This can either be a fully specified path (vol:path), or it can be relative to dirHandle.

srcNamSpc

(IN) Specifies the name space referred to by dirHandle/path (see Section 20.5, Name Space Flag Values).

dstNamSpc

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

longName

(OUT) Points to a buffer returning the corresponding name space’s name (up to 256 bytes).

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

Remarks

longName includes only the name of the last component in the path. NWGetLongName does not translate the entire path to a new name in the designated name space.

The name returned is the same name returned by NWGetNSEntryInfo.

NCP Calls

See Also

NWGetNSEntryInfo, NWGetNSPath, NWSetLongName