GetBinderyAccessLevel

Indicates the access level of the current connection number to the server’s bindery (For cross-platform functionality, see Developing NLMs with Cross-Platform Functions ( NDK: NLM Development Concepts, Tools, and Functions) and call NWGetBinderyAccessLevel )

Local Servers:blocking
Remote Servers:blocking
Classification:3.x, 4.x, 5.x, 6.x
Service:Server-Based Bindery

Syntax

   #include <\nlm\nit\nwbindry.h>  
    
   int GetBinderyAccessLevel (  
      BYTE   *securityAccessLevel,  
      long   *objectID);

Parameters

securityAccessLevel
(OUT) Receives the security access level the requesting object has to the bindery.
objectID
(OUT) Receives the unique ID of the bindery object logged in to the current connection or else a value of -1 if no object is logged in on the current connection.

Return Values

0

(0x00)

ESUCCESS

Remarks

Object security determines who can access the object. The low-order nibble determines who can read (scan for and find) the object. The high-order nibble determines who can write to (add properties to or delete properties from) the object.

The following values are defined for each nibble:

0

0 0 0 0

Anyone

1

0 0 0 1

Logged

2

0 0 1 0

Object

3

0 0 1 1

Supervisor

4

0 1 0 0

NetWare Operating System

For example, 0x31 indicates that any user logged in to the server can find the object, but only the supervisor can add a property to the object.

See Also

GetBinderyObjectName, ScanBinderyObject, ScanProperty

GetBinderyAccessLevel Example

   #include <stdio.h>  
   #include <\nlm\nit\nwbindry.h>  
    
   main()  
   {  
   int    completionCode;  
   BYTE   securityAccessLevel;  
   long   objectID;  
    
      GetBinderyObjectID ("JDOE", OT_USER, &objectID);  
      completionCode = GetBinderyAccessLevel (&securityAccessLevel,  
      objectID);  
      if (completionCode == 0)  
      {  
         printf (" \n\n\nSUCCESSFUL\n\n");  
         printf ("Security Access Level —> %2X\n",  
         securityAccessLevel);  
      }  
      else  
         printf ("Error %d in GetBinderyAccessLevel\n",  
                  completionCode);  
   }