NWCreateProperty

Adds a property to a bindery object on the NetWare server associated with the given connection handle

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  NWCreateProperty  ( 
      NWCONN_HANDLE       conn,  
      const nstr8 N_FAR  *objName,  
      nuint16             objType,  
      const nstr8 N_FAR  *propertyName,  
      nuint8              propertyFlags,  
      nuint8              propertySecurity);
   

Pascal

   uses calwin32 
    
   Function NWCreateProperty 
     (conn : NWCONN_HANDLE; 
      const objName : pnstr8; 
      objType : nuint16; 
      const propertyName : pnstr8; 
      propertyFlags : nuint8; 
      propertySecurity : nuint8 
   ) : NWCCODE; stdcall;
   

Parameters

conn
(IN) Specifies the NetWare server connection handle.
objName
(IN) Points to the object name receiving the new property.
objType
(IN) Specifies the type of the affected bindery object.
propertyName
(IN) Points to the name of the property being created.
propertyFlags
(IN) Specifies the bindery flags of the new property (ORed with BF_ITEM or BF_SET):
  • BF_DYNAMIC
  • BF_STATIC
propertySecurity
(IN) Specifies the security access mask of the new property.

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

0x89ED

PROPERTY_ALREADY_EXISTS

0x89EF

INVALID_NAME

0x89F0

WILD_CARD_NOT_ALLOWED

0x89F1

INVALID_BINDERY_SECURITY

0x89F2

NO_OBJECT_READ_PRIVILEGE

0x89F6

NO_PROPERTY_DELETE_PRIVILEGE

0x89F7

NO_PROPERTY_CREATE_PRIVILEGE

0x89FB

N0_SUCH_PROPERTY

0x89FC

NO_SUCH_OBJECT

0x89FE

BINDERY_LOCKED

0x89FF

HARDWARE_FAILURE

Remarks

NWCreateProperty requires Write access to the bindery object.

The requesting process cannot create properties having a greater security level than the access level of the process.

The PASSNWOBJ_TYPE property is created by calling the NWChangeObjectPassword function, rather than by calling NWCreateProperty.

See Section 4.3, Security Rights Mask Values.

See Object Type.

NCP Calls

See Also

NWChangeObjectPassword, NWCreateObject