The UPMELOCL API invokes User Profile Management to display a local logon window. This allows users to enter their user IDs and passwords to perform a local logon to the system.

Restrictions

A call to this API can be issued only from an OS/2 application to the local computer.

If a user already is logged on locally, the return code UPM_OK is returned. If a user already is logged on to the domain, this function attempts to use the user ID and password to log on locally. If that attempt is unsuccessful, the function displays the local logon window with the user ID in the USER ID field. The password is not displayed.

Syntax

#include <upm.h>
 
LSINT LSFAR LSPAS
UPMELOCL(pszUserID, pAuthorityLevel);    /* 16 bit */
 
LSINT LSFAR LSPAS
U32ELOCL(pszUserID, pAuthorityLevel);    /* 32 bit */

Parameters

See Common Parameter Definitions for descriptions of parameters not defined here.

pAuthorityLevel

(16-bit unsigned short LSFAR * or 32-bit unsigned long LSFAR *) points to the level of access authority for this user, which can be UPM_USER, UPM_LOCAL_ADMIN, or UPM_ADMIN.
Return Codes

The following table lists the return codes most significant to this API. (See API Return Codes for a complete list of return codes.) ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÂÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿³SYMBOLICCONSTANT ³MEANING ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³ UPM_OK ³ The user was logged on successfully. ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³ UPM_LOG_CANCEL ³ The user cancelled from the logon ³
³ ³ panel. ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³ UPM_LOG_INPROC ³ Another logon was being processed; ³
³ ³ the logon attempt was not suc- ³
³ ³ cessful. ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³ UPM_SYS_ERROR ³ A system error occurred. ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÁÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ


---

[Back] [Next]