The UPMEUSRL API returns a list of logged-on user IDs. You can use this API to get all user IDs logged on at a particular local machine, without having to specify a server name. The type of user IDs returned depends on the remotetype input parameter.

Restrictions

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

To use this API, you must be linked to the UPM.LIB library.

Syntax

#include <upm.h>
 
 
LSINT LSFAR LSPAS
UPMEUSRL(pszRemotename, remotetype, buf,
         usBuflen, pusEntriesReturned, pusEntriesAvail);     /* 16 bit */
 
LSINT LSFAR LSPAS
U32EUSRL(pszRemotename, remotetype, buf,
         ulBuflen, pulEntriesReturned, pulEntriesAvail);     /* 32 bit */

Parameters

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

pszRemotename

(unsigned char LSFAR *) points to the name identifying the node or domain from which the logged-on user IDs are requested. If remotetype is UPM_LOCAL, UPM_LOCAL_HPFS, UPM_DOMAIN, or NULL, pszRemotename is ignored.
remotetype
(16-bit short or 32-bit unsigned long) specifies about which users to return information. The following are the possible values: ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÂÄÄÄÄÄÄÄÂÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
³ SYMBOLIC CONSTANT ³ VALUE ³ MEANING ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³ UPM_LOCAL ³ 1 ³ User IDs logged on to the local node ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³ UPM_DNODE ³ 2 ³ User IDs logged on to remote nodes ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³ UPM_DOMAIN ³ 3 ³ All LAN Server Logons, whether local, domain, or ³
³ ³ ³ invalidated. ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³ UPM_LOCAL_HPFS ³ 21 ³ User IDs logged on to the high performance file ³
³ ³ ³ system ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³ UPM_ALL ³ 22 ³ All user IDs ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÁÄÄÄÄÄÄÄÁÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ

buf
(unsigned char LSFAR *) points to a UPM logon data structure with the following format.

---

[Back] [Next]