NWCreateObject(3nw)

Synopsis

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

Description

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 to be dynamic (BF_DYNAMIC) or static (BF_STATIC).

objSecurity

(IN) Specifies the new object's access rights mask.

Return values

0x0000

SUCCESSFUL

0x8801

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

Notices

Requires SUPERVISOR or equivalent rights.

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

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

objSecurity is a byte in which the low nibble controls Read security while the high nibble controls Write security. Read security controls which objects and properties the workstation can find when it scans the bindery. Write security determines which clients can create properties for the bindery object. The Read and Write values are described in the following table:

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 find the object, but only a client with security equivalence to SUPERVISOR can add properties to it.

The bindery object must have a PASSNWOBJ_TYPE to log in to a NetWare server. PASSNWOBJ_TYPE is created with NWChangeObjectPassword.

Services

Bindery

NCP calls

References