NWCreateProperty(3nw)


NWCreateProperty -- adds a property to a bindery object on the NetWare server associated with the given connection handle

Synopsis

   #include <nwbindry.h> 
   or 
   #include <nwcalls.h> 
   

NWCCODE N_API NWCreateProperty (NWCONN_HANDLE conn, pnstr8 objName, nuint16 objType, pnstr8 propertyName, nuint8 propertyFlags, nuint8 propertySecurity);

Description

The parameters are as follows:

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): either BF_STATIC or BF_DYNAMIC.

propertySecurity
(IN) Specifies the new property's security access mask.

Return values

0x0000
SUCCESSFUL

0x8801
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

Notices

NWCreateProperty requires Write access to the bindery object.

propertyFlags defines a property's type and whether the property is dynamic. A dynamic property is one that is created and deleted frequently. Dynamic properties are deleted from the bindery when the NetWare server is reinitialized.

The property type indicates the type of data a property value contains. SET property types contain a set of bindery object identifications. The bindery attaches no significance to the contents of a property value if the property is of type ITEM.

propertySecurity is a byte in which the low nibble controls Read security and the high nibble controls Write security. Read security controls which clients can read the property. Write security controls which clients can write to the property. The following table describes propertySecurity values:

Read Value Write Value Access Level Description
BS_ANY_READ BS_ANY_WRITE Anyone Access allowed to all clients, even if the client has not logged in to the server.
BS_LOGGED_READ BS_LOGGED_WRITE Logged Access allowed to all clients logged in to the server.
BS_OBJECT_READ BS_OBJECT_WRITE Object Access allowed only to clients who have logged in to the server with object's name, type, and password.
BS_SUPER_READ BS_SUPER_WRITE SUPERVISOR Access allowed only to clients who have logged in to the server as SUPERVISOR, or as a bindery object that is security-equivalent to SUPERVISOR
BS_BINDERY_READ BS_BINDERY_WRITE NetWare Access allowed only to NetWare.

 
 ----------------------------------------------------------------------- 
| Read Value     |  Write Value     |  Access Level|  Description      | 
|----------------|------------------|--------------|-------------------| 
| BS_ANY_READ    |  BS_ANY_WRITE    |  Anyone      |  Access allowed to| 
|                |                  |              |  all clients, even| 
|                |                  |              |  if the client has| 
|                |                  |              |  not logged in to | 
|                |                  |              |  the server.      | 
|----------------|------------------|--------------|-------------------| 
| BS_LOGGED_READ |  BS_LOGGED_WRITE |  Logged      |  Access allowed to| 
|                |                  |              |  all clients      | 
|                |                  |              |  logged in to the | 
|                |                  |              |  server.          | 
|----------------|------------------|--------------|-------------------| 
| BS_OBJECT_READ |  BS_OBJECT_WRITE |  Object      |  Access allowed   | 
|                |                  |              |  only to clients  | 
|                |                  |              |  who have logged  | 
|                |                  |              |  in to the server | 
|                |                  |              |  with object's    | 
|                |                  |              |  name, type, and  | 
|                |                  |              |  password.        | 
|----------------|------------------|--------------|-------------------| 
| BS_SUPER_READ  |  BS_SUPER_WRITE  |  SUPERVISOR  |  Access allowed   | 
|                |                  |              |  only to clients  | 
|                |                  |              |  who have logged  | 
|                |                  |              |  in to the server | 
|                |                  |              |  as SUPERVISOR, or| 
|                |                  |              |  as a bindery     | 
|                |                  |              |  object that is   | 
|                |                  |              |  security-        | 
|                |                  |              |  equivalent to    | 
|                |                  |              |  SUPERVISOR       | 
|----------------|------------------|--------------|-------------------| 
| BS_BINDERY_READ|  BS_BINDERY_WRITE|  NetWare     |  Access allowed   | 
|                |                  |              |  only to NetWare. | 
|----------------|------------------|--------------|-------------------| 

Values can be ORed together. For example, BS_SUPER_WRITE ORed with BS_LOGGED_READ (Hex 0x31) indicates any user logged in to the NetWare server can read a property, but only a client with SUPERVISOR security equivalence can write to the property.

The requesting process cannot create properties having security greater than the process' access to the bindery object.

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

Services

Bindery

NCP calls

0x2222 23 57 Create Property

References

NWChangeObjectPassword(3nw), NWCreateObject(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.