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.