NWChangePropertySecurity

Changes the security access mask of a property in a bindery object on the NetWare server associated with the given connection identification

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

Pascal

   uses calwin32 
    
   Function NWChangePropertySecurity 
     (conn : NWCONN_HANDLE; 
      const objName : pnstr8; 
      objType : nuint16; 
      const propertyName : pnstr8; 
      newPropertySecurity : nuint8 
   ) : NWCCODE; stdcall;
   

Parameters

conn
(IN) Specifies the NetWare server connection handle on which the security property should be changed.
objName
(IN) Points to the name of the bindery object associated with the property whose security is being changed.
objType
(IN) Specifies the type of the object described by the objName parameter.
propertyName
(IN) Points to the name of the affected property.
newPropertySecurity
(IN) Specifies the new security access mask for the 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

0x89F0

WILD_CARD_NOT_ALLOWED

0x89F1

INVALID_BINDERY_SECURITY

0x89F2

NO_OBJECT_READ_PRIVILEGE

0x89F5

NO_OBJECT_CREATE_PRIVILEGE

0x89F6

NO_PROPERTY_DELETE_PRIVILEGE

0x89FC

NO_SUCH_PROPERTY

0x89FC

NO_SUCH_OBJECT

0x98FE

BINDERY_LOCKED

0x89FF

HARDWARE_FAILURE

Remarks

NWChangePropertySecurity requires Write access to the bindery object and Read and Write access to the property.

The objName, objType, and propertyName parameters must uniquely identify the property and cannot contain wildcards.

NWChangePropertySecurity cannot set or clear bindery Read or Write security. The requesting process cannot change the security of a property to a level greater than the property access of the process.

See Section 4.3, Security Rights Mask Values.

See Object Type.

See Section 4.1, Extended Object Type Values.

NCP Calls

See Also

NWChangeObjectSecurity