Syntax

  #include <nwcntask.h>  
   
  int LoginObject  (  
     LONG   connection,   
     char   *objectName,   
     WORD   objectType,   
     char   *password); 
  

Parameters

connection

(IN) Specifies the connection number the object is to be logged in to.

objectName

(IN) Points to the string containing the name of the object.

objectType

(IN) Specifies the type of the object.

password

(IN) Points to the string containing the object’s password (lowercase passwords can be specified).

Return Values

The following table lists return values and descriptions.

Remarks

Call SetCurrentConnection first to select the connection, or call GetCurrentConnection to obtain the current connection. The current file server ID does not change.

The objectType parameter classifies an object as a user, user group, server, and so on. The following is a list of well-known object types:

An NLM typically uses object type 1 (user) or a type that the developer has requested from Novell®.

LoginObject logs in the object on the specified connection on the local server with the specified object name and type and with the specified password.

To log in as an object on a remote server, you must specify the object’s password for the password parameter. On the local server, an NLM application can log in as an object without specifying the object’s password. This is done by specifying LOGIN_WITHOUT_PASSWORD for the password parameter. If your application uses LOGIN_WITHOUT_PASSWORD, it must ensure that NetWare security is not breached.

See Also

NWLoginToFileServer (Server Management), LogoutObject