NetGetRIPLMachineInfo or Net32GetRIPLMachineInfo

The NetGetRIPLMachineInfo API retrieves information about a RIPL workstation.

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.

#include <ripl.h>
 
NetGetRIPLMachineInfo(pszServername,
          MachineName, sLevel, buf,
          usBuflen, pusBytesAvail);   /* 16 bit */
 
Net32GetRIPLMachineInfo(pszServername,
            MachineName, ulLevel, buf,
            ulBuflen, pulBytesAvail);   /* 32 bit */

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

MachineName

(unsigned char LSFAR *) points to an ASCIIZ string containing the name of the RIPL workstation definition for which information is to be retrieved. This pointer cannot be NULL.

sLevel

ulLevel

ripl_machine_info

RIPL Machine Data Structures

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_MACHINESFileNotFound Г 5407 Г An error was detected while reading Г
Г Г Г configuration files in the Г
Г Г Г IBMLAN\RPL\MACHINES directory tree on Г
Г Г Г the remote IPL server. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_RPLUSERFileNotFound Г 5409 Г An error was detected while reading Г
Г Г Г configuration files in the Г
Г Г Г IBMLAN\RPLUSER directory tree on the Г
Г Г Г remote IPL server. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_RPLFileNotFound Г 5410 Г An error was detected while reading Г
Г Г Г configuration files in the IBMLAN\RPL Г
Г Г Г directory tree on the remote IPL Г
Г Г Г server. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_MachineFilesLocked Г 5411 Г Machine configuration files are Г
Г Г Г locked by the remote IPL server file Г
Г Г Г system. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_MachNameTooLong Г 5415 Г Machine definition names for DOS or Г
Г Г Г FAT file systems cannot exceed 8 Г
Г Г Г bytes. Г
РФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФСФФФФФФФСФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФй

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

[Back]

[Next]