The NetEnumRIPLMachine API lists RIPL workstations of the specified types on a server.

Restrictions

A process with any access authority can call this API with a level of 0 or 1. To call this API with a level of 2, the calling process must have administrator privilege or server operator privilege.

Syntax

#include <ripl.h>
 
NetEnumRIPLMachine(pszServername, sLevel, type,
               buf, usBuflen, pusEntriesReturned,
               pusEntriesAvail);         /* 16 bit */
 
Net32EnumRIPLMachine(pszServername, ulLevel, type,
               buf, ulBuflen, pulEntriesReturned,
               pulEntriesAvail);         /* 32 bit */

Parameters

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

sLevel or ulLevel

(16-bit unsigned short or 32-bit unsigned long) must be 0, 1, or 2, specifying the level of detail for the ripl_machine_info structure, as described in RIPL Machine Data Structures.
type
(16-bit unsigned short or 32-bit unsigned long) indicates the types of RIPL workstation definitions that are to be returned in buf. The following types are defined in RIPL.H: ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÂÄÄÄÄÄÄÄÄÄÄ¿
³ SYMBOLIC CONSTANT ³ BIT MASK ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄ´
³ MTYPE_OS2_RIPL_REQ ³ 0x0001 ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄ´
³ MTYPE_DOS_RIPL_REQ ³ 0x0002 ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÁÄÄÄÄÄÄÄÄÄÄÙ

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 ³VALUE³MEANING ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³ NERR_NotRIPLServer ³ 5401 ³ The server name specified is not a ³
³ ³ ³ valid remote IPL server. ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³ NERR_RPL_MAPNotFound ³ 5402 ³ The RPL.MAP file was not found or ³
³ ³ ³ could not be opened on the remote IPL ³
³ ³ ³ server. ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³ NERR_RPL_MAPReadError ³ 5403 ³ An error was detected while reading ³
³ ³ ³ the RPL.MAP file on the remote IPL ³
³ ³ ³ server. ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³ NERR_MachineNotFound ³ 5405 ³ The machine definition does not exist ³
³ ³ ³ on the remote IPL server. ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³ NERR_EnumMachNotFound ³ 5450 ³ A machine definition of the type ³
³ ³ ³ requested does not exist on the remote ³
³ ³ ³ IPL server. ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÁÄÄÄÄÄÄÄÁÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ


Remarks

If you call this API with the buffer length parameter equal to zero, the API returns a value for total entries available. This technique is useful if you do not know the exact buffer size required.

Related Information

For information about listing all servers (members of group SERVERS) or all OS/2 requesters (members of group RPLGROUP) in a domain, see Group - NetGroupGetUsers.

---

[Back] [Next]