NWGetNSEntryInfo

Returns name space entry information for the entry referred to by the dirHandle and path combination

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  NWGetNSEntryInfo  ( 
      NWCONN_HANDLE          conn,  
      NWDIR_HANDLE           dirHandle,  
      const nstr8 N_FAR     *path,  
      nuint8                 srcNamSpc,  
      nuint8                 dstNamSpc,   
      nuint16                searchAttrs,  
      nuint32                retInfoMask,  
      NW_ENTRY_INFO N_FAR   *entryInfo);
   

Delphi Syntax

   uses calwin32 
    
   Function NWGetNSEntryInfo 
     (conn : NWCONN_HANDLE; 
      dirHandle : nuint8; 
      const path : pnstr8; 
      srcNamSpc : nuint8; 
      dstNamSpc : nuint8; 
      searchAttrs : nuint16; 
      retInfoMask : nuint32; 
      Var entryInfo : NW_ENTRY_INFO 
   ) : NWCCODE;
   

Parameters

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 (see Section 20.5, Name Space Flag Values).

dstNamSpc

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

searchAttrs

(IN) Specifies the search attributes to use (see Section 20.8, Search Attributes Values).

retInfoMask

(IN) Specifies the information to return (see Section 20.6, Basic Return Mask Values).

entryInfo

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

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

0x89BF

INVALID_NAME_SPACE

0x89FF

Bad Parameter—no constant

Remarks

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.

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

NCP Calls

See Also

NWGetOwningNameSpace, NWGetLongName