NWGetNSEntryInfo(3nw)

Synopsis

   #include <nwnamspc.h> 
   or 
   #include <nwcalls.h> 
   
 
   NWCCODE N_API NWGetNSEntryInfo 
     (NWCONN_HANDLE           conn, 
      NWDIR_HANDLE            dirHandle, 
      pnstr8                  path, 
      nuint8                  srcNamSpc, 
      nuint8                  dstNamSpc, 
      nuint16                 searchAttrs, 
      nuint32                 retInfoMask, 
      NW_ENTRY_INFO N_FAR    entryInfo); 

Description

conn

(IN) Specifies the NetWare server connection handle.

dirHandle

(IN) Specifies the directory handle associated with the desired name space (optional).

path

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

srcNamSpc

(IN) Specifies the name space of dirHandle/path.

dstNamSpc

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

searchAttrs

(IN) Specifies the search attributes to use.

retInfoMask

(IN) Specifies the information to return.

entryInfo

(OUT) Points to NW_ENTRY_INFO. Only fields related to retInfoMask are valid.

Return values

0x0000

SUCCESSFUL

0x8801

INVALID_CONNECTION

0x8998

VOLUME_DOES_NOT_EXIST

0x899B

BAD_DIRECTORY_HANDLE

0x899C

INVALID_PATH

0x89BF

INVALID_NAME_SPACE

0x89FF

Bad Parameter---no constant

Notices

dirHandle can be zero if path contains the complete path, including the volume name. dirHandle and/or path contains the entry name according to srcNamSpc This information is returned for dstNamSpc.

searchAttrs values follow:

C Value	Value Name	Value Description
0x00	TA_NONE	Specifies no Reads or Writes are allowed.
0x01	TA_READ	Specifies file Reads are allowed.
0x02	TA_WRITE	Specifies file Writes are allowed.
0x04	TA_OPEN	Specifies files can be opened; obsolete in 3.x and higher.
0x08	TA_CREATE	Specifies files can be created.
0x10	TA_DELETE	Specifies files can be deleted.
0x20	TA_OWNERSHIP	Specifies subdirectories can be created or deleted and trustee rights granted or revoked.
0x40	TA_SEARCH	Specifies the directory can be searched.
0x80	TA_MODIFY	Specifies file attributes can be modified.
0xFB	TA_ALL	Specifies the trustee has all the above rights to the directory.

 
 -------------------------------------------------- 
| C Value|  Value Name     |  Value Description   | 
|--------|-----------------|----------------------| 
| 0x00   |  TA_NONE        |  Specifies no Reads  | 
|        |                 |  or Writes are       | 
|        |                 |  allowed.            | 
|--------|-----------------|----------------------| 
| 0x01   |  TA_READ        |  Specifies file Reads| 
|        |                 |  are allowed.        | 
|--------|-----------------|----------------------| 
| 0x02   |  TA_WRITE       |  Specifies file      | 
|        |                 |  Writes are allowed. | 
|--------|-----------------|----------------------| 
| 0x04   |  TA_OPEN        |  Specifies files can | 
|        |                 |  be opened; obsolete | 
|        |                 |  in 3.x and higher.  | 
|--------|-----------------|----------------------| 
| 0x08   |  TA_CREATE      |  Specifies files can | 
|        |                 |  be created.         | 
|--------|-----------------|----------------------| 
| 0x10   |  TA_DELETE      |  Specifies files can | 
|        |                 |  be deleted.         | 
|--------|-----------------|----------------------| 
| 0x20   |  TA_OWNERSHIP   |  Specifies           | 
|        |                 |  subdirectories can  | 
|        |                 |  be created or       | 
|        |                 |  deleted and trustee | 
|        |                 |  rights granted or   | 
|        |                 |  revoked.            | 
|--------|-----------------|----------------------| 
| 0x40   |  TA_SEARCH      |  Specifies the       | 
|        |                 |  directory can be    | 
|        |                 |  searched.           | 
|--------|-----------------|----------------------| 
| 0x80   |  TA_MODIFY      |  Specifies file      | 
|        |                 |  attributes can be   | 
|        |                 |  modified.           | 
|--------|-----------------|----------------------| 
| 0xFB   |  TA_ALL         |  Specifies the       | 
|        |                 |  trustee has all the | 
|        |                 |  above rights to the | 
|        |                 |  directory.          | 
|--------|-----------------|----------------------| 

To request information from a server, a client sets the appropriate bit or bits of retInfoMask and sends a request packet to the server.

Services

Name Space

NCP calls

0x2222 87 06

Obtain File Or Subdirectory Information

References