NWGetLongNameExt

Retrieves a filename for the specified name space, using UTF-8 strings

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 NWGetLongNameExt ( 
      NWCONN_HANDLE       conn,  
      nuint8              dirHandle,  
      const nstr8 N_FAR  *path,  
      nuint8              srcNamSpc,  
      nuint8              dstNamSpc,  
      pnstr8              longName);

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

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

Remarks

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

The name returned is the same name returned by NWGetNSEntryInfoExt.

NCP Calls

0x2222 87 06 Obtain File or Subdirectory Information
0x2222 89 06 Obtain File or Subdirectory Information