NWOpenEAExt

Fills the NW_EA_HANDLE_EXT structure so it can be used by the NWReadEAExt and NWWriteEAExt functions

Local Servers:blocking
Remote Servers:blocking
NetWare Server:6.5 SP2 or later
Platform:NLM, Windows 2000, Windows XP
Client:4.90 SP2 or later
Library:Cross-Platform NetWare Calls (CAL*.*)
Service:Extended Attribute

Syntax

  #include <nwnamspc.h> 
  #include <nwea.h> 
  or 
  #include <nwcalls.h> 
   
  N_EXTERN_LIBRARY(NWCCODE) NWOpenEAExt ( 
     NWCONN_HANDLE            conn,  
     NWDIR_HANDLE             dirHandle,  
     const nstr8     N_FAR   *path,  
     pnstr8                   EAName,  
     nuint8                   nameSpace,  
     NW_EA_HANDLE_EXT N_FAR  *EAHandle);
  

Parameters

conn
(IN) Specifies the NetWare server connection handle.
dirHandle
(IN) Specifies the NetWare directory handle pointing to the directory to search.
path
(IN) Points to a path. The characters in the string must be UTF-8.
EAName
(IN) Points to the string containing the name of the Extended Attribute, using UTF-8 characters.
nameSpace
(IN) Specifies the name space of the Extended Attribute (see Name Space Flag Values (Multiple and Inter-File Services)).
EAHandle
(IN/OUT) Points to the NW_EA_HANDLE_EXT structure containing the handle of the current Extended Attribute.

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

Remarks

NWOpenEAExt combines the functionality of the NWGetDirectoryBaseExt and NWGetEAHandleStructExt functions in one function.

The NWFindFirstEAExt and NWFindNextEAExt functions also return a filled NW_EA_HANDLE_EXT structure.

NOTE:For information about the requirments for using the ...Ext family of extended attribute functions, see UTF-8 Path and Filenames in Multiple and Inter-File Services.

NCP Calls

See Also

NWFindFirstEAExt, NWFindNextEAExt, NWGetDirectoryBaseExt (Multiple and Inter-File Management), NWGetEAHandleStructExt, NWReadEAExt, NWWriteEAExt