UPMELOCU or U32ELOCU

The UPMELOCU API retrieves an ID of a local user that already is logged on to the system.

Restrictions

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

If the LOGON /0=MULTI option has been issued, the return code is UPM_NOT_LOGGED.

Syntax

#include <upm.h>
 
LSINT LSFAR LSPAS
UPMELOCU(pszUserID, pLocalAuthority);    /* 16 bit */
 
LSINT LSFAR LSPAS
U32ELOCU(pszUserID, pLocalAuthority);    /* 32 bit */

Parameters

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

pLocalAuthority

(16-bit unsigned short LSFAR * or 32-bit unsigned long LSFAR *) points to this user's level of local access authority for an HPFS386 Server with local security installed. This 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_NOT_LOGGED │ The user has not logged on locally. │
├───────────────────────────────────────┼──────────────────────────────────────┤
│ UPM_LOG_INPROC │ A logon is in process. │
├───────────────────────────────────────┼──────────────────────────────────────┤
│ UPM_SYS_ERROR │ A system error occurred. │
└───────────────────────────────────────┴──────────────────────────────────────┘


---

[Back: UPMELOCL or U32ELOCL]
[Next: UPMEULGF or U32EULGF]