NWGetLongName(3nw)


NWGetLongName -- retrieves file name for dstNamSpace

Synopsis

   #include <nwnamspc.h> 
   or 
   #include <nwcalls.h> 
   

NWCCODE N_API NWGetLongName (NWCONN_HANDLE conn, nuint8 dirHandle, pnstr8 path, nuint8 srcNamSpc, nuint8 dstNamSpc, pnstr8 longName);

Description

The parameters are as follows:

conn
(IN) Specifies the NetWare server connection handle.

dirHandle
(IN) Specifies the directory handle associated with the directory to scan.

path
(IN) Points to a valid path.

srcNamSpc
(IN) Specifies the name space referred to by dirHandle/path.

dstNamSpc
(IN) Specifies the name space for the return name.

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

Return values

0x0000
SUCCESSFUL

0x8801
INVALID_CONNECTION

0x8998
VOLUME_DOES_NOT_EXIST

0x899B
BAD_DIRECTORY_HANDLE

0x899C
INVALID_PATH

Notices

For OS/2, the dirHandle/path combination must be in the same name space as srcNamSpc.

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

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.

Services

Name Space

NCP calls

0x2222 87 06
Obtain File or Subdirectory Information

References

NWGetNSEntryInfo(3nw), NWGetNSPath(3nw), NWSetLongName(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.