NWAllocTempNSDirHandle2Ext

Assigns a temporary directory handle in the specified name space, using UTF-8 strings

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:Name Space

Syntax

   #include <nwnamspc.h> 
   or 
   #include <nwcalls.h> 
    
   NWCCODE N_API NWAllocTempNSDirHandle2Ext ( 
      NWCONN_HANDLE       conn,  
      nuint8              dirHandle,  
      const nstr8 N_FAR  *path,  
      nuint8              nameSpc,  
      pnuint8             newDirHandle,  
      nuint8              newNameSpace);
   

Parameters

conn

(IN) Specifies the NetWare server connection handle through which to attach.

dirHandle

(IN) Specifies the directory handle associated with the desired directory path.

path

(IN) Points to an absolute path, (or relative if dirHandle is non-zero), with which dirHandle is to be associated. The characters in the string must be UTF-8.

namSpc

(IN) Specifies the name space of the dirHandle/path combination (see Section 20.5, Name Space Flag Values).

newDirHandle

(OUT) Points to the new directory handle.

newNameSpc

(IN) Specifies the name space to be used for the new directory handle (see Section 20.5, Name Space Flag Values).

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

0x8998

VOLUME_DOES_NOT_EXIST

0x899B

BAD_DIRECTORY_HANDLE

0x899C

INVALID_PATH

0x89BF

INVALID_NAME_SPACE

NCP Calls

See Also

NWAllocTempNSDirHandle2