NetDeleteRIPLMachine or Net32DeleteRIPLMachine

The NetDeleteRIPLMachine API deletes a RIPL workstation definition.

Restrictions

This API requires the user have administrator privilege. If a session already is active between a workstation and its RIPL server, this API does not function.

#include <ripl.h>
 
NetDeleteRIPLMachine(pszServername,
             MachineName);   /* 16 bit */
 
Net32DeleteRIPLMachine(pszServername,
             MachineName);   /* 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 that is to be deleted.

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_RPL_MAPWriteError │ 5404 │ An error occurred while updating the │
│ │ │ RPL.MAP file on the remote IPL server. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_MachineNotFound │ 5405 │ The machine definition does not exist │
│ │ │ 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. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_DelMachFailure │ 5440 │ The machine definition could not be │
│ │ │ deleted. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_DelMachDirFailure │ 5441 │ An error was detected while deleting │
│ │ │ machine configuration directories on │
│ │ │ the remote IPL server. │
└─────────────────────────────┴───────┴────────────────────────────────────────┘

[Back: NetCreateRIPLMachine or Net32CreateRIPLMachine]

[Next: NetEnumRIPLMachine or Net32EnumRIPLMachine]