(IN) Specifies the NetWare server connection handle on which the action
is to be performed.
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 objName.
propertyName
(IN) Points to the name of the affected property.
newPropertySecurity
(IN) Specifies the new security access mask for the property.
Return values
0x0000
SUCCESSFUL
0x8801
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
Notices
NWChangePropertySecurity requires Write access to the bindery
object, and Read and Write access to the property.
objName, objType, and propertyName must
uniquely identify the property and cannot contain wildcards.
newPropertySecurity is a byte in which the low nibble controls
Read security and the high nibble controls Write security. Read security
determines which clients can read the property. Write security determines
which clients can write to the property. The following table describes
each security level:
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_LOGGD_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.
Valid bindery object types for OT_ constants follow :
0xFFFF
OT_WILD
0x0000
OT_UNKNOWN
0x0100
OT_USER
0x0200
OT_USER_GROUP
0x0300
OT_PRINT_QUEUE
0x0400
OT_FILE_SERVER
0x0500
OT_JOB_SERVER
0x0600
OT_GATEWAY
0x0700
OT_PRINT_SERVER
0x0800
OT_ARCHIVE_QUEUE
0x0900
OT_ARCHIVE_SERVER
0x0A00
OT_JOB_QUEUE
0x0B00
OT_ADMINISTRATION
0x2100
OT_NAS_SNA_GATEWAY
0x2600
OT_REMOTE_BRIDGE_SERVER
0x2700
OT_TCPIP_GATEWAY
Extended bindery object types follow:
0x2D00
OT_TIME_SYNCHRONIZATION_SERVER
0x2E00
OT_ARCHIVE_SERVER_DYNAMIC_SAP
0x4700
OT_ADVERTISING_PRINT_SERVER
0x5000
OT_BTRIEVE_VAP
0x5300
OT_PRINT_QUEUE_USER
NWChangePropertySecurity cannot set or clear bindery Read or
Write security. The requesting process cannot change a property's
security to a level greater than the process' access to the property.