NWGetNSEntryInfoExt

Returns name space entry information for the specified entry, using UTF-8 strings

Local Servers:blocking

Remote Servers:blocking

NetWare Server:6.5 SP2 and 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  NWGetNSEntryInfoExt  ( 
      NWCONN_HANDLE                conn,  
      NWDIR_HANDLE                 dirHandle,  
      const nstr8 N_FAR           *path,  
      nuint8                       srcNamSpc,  
      nuint8                       dstNamSpc,   
      nuint16                      searchAttrs,  
      nuint32                      retInfoMask,  
      NW_ENTRY_INFO_EXT  N_FAR    *entryInfo);

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). The characters in the string must be UTF-8.
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_EXT. 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
0x88F0	UTF8_CONVERSION_FAILED
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