NWCreateObject

Creates a bindery object

Local Servers:blocking
Remote Servers:blocking
NetWare Server:3.11, 3.12, 4.x, 5.x, 6.x
Platform:NLM, Windows NT, Windows 95, Windows 98
Library:Cross-Platform NetWare Calls (CAL*.*)
Service:Bindery

Syntax

C

   #include <nwbindry.h> 
   or 
   #include <nwcalls.h> 
    
   NWCCODE N_API  NWCreateObject  ( 
      NWCONN_HANDLE   conn,  
      pnstr8          objName,  
      nuint16         objType,  
      nuint8          objFlags,  
      nuint8          objSecurity);
   

Pascal

   uses calwin32 
    
   Function NWCreateObject 
     (conn : NWCONN_HANDLE; 
      objName : pnstr8; 
      objType : nuint16; 
      objFlags : nuint8; 
      objSecurity : nuint8 
   ) : NWCCODE; stdcall;
   

Parameters

conn
(IN) Specifies the NetWare server connection handle.
objName
(IN) Points to the string containing the new object name.
objType
(IN) Specifies the bindery type of the new object.
objFlags
(IN) Specifies whether the new object is dynamic:
  • BF_DYNAMIC
  • BF_STATIC
objSecurity
(IN) Specifies the access rights mask of the new object.

Return Values

These are common return values. See Return Values (Return Values for C).

0x0000

SUCCESSFUL

0x8801

INVALID_CONNECTION

0x890A

NLM_INVALID_CONNECTION

0x8996

SERVER_OUT_OF_MEMORY

0x89E7

E_NO_MORE_USERS

0x89EE

OBJECT_ALREADY_EXISTS

0x89EF

INVALID_NAME

0x89F1

INVALID_BINDERY_SECURITY

0x89F5

NO_OBJECT_CREATE_PRIVILEGE

0x89FC

NO_SUCH_OBJECT

0x89FE

BINDERY_LOCKED

0x89FF

HARDWARE_FAILURE

Remarks

NWCreateObject requires SUPERVISOR or equivalent rights.

The objName and objType parameters must uniquely identify the bindery object and cannot contain wildcards.

The bindery object must have a PASSNWOBJ_TYPE to log in to a NetWare server. PASSNWOBJ_TYPE is created by calling the NWChangeObjectPassword function.

See Section 4.3, Security Rights Mask Values.

See Object Type.

NCP Calls

See Also

NWChangeObjectPassword, NWCreateProperty