NetAppDel or Net32AppDel

The NetAppDel API deletes an application definition.

The NetAppSetInfo API can be used to delete an application's list data (redirections associated with an application).

Restrictions

This API can be called from DLS and OS/2 workstations, but DLS workstations can issue this call only to a remote LAN Server workstation. This remote call can also be issued to an OS/2 Warp Server or Directory and Security Server workstation.

A successful call to NetAppDel requires one of the following:

The calling process has Administrator authority .
The calling process has server operator privilege.
The calling process has User authority and is deleting a private application for the logged-on user.

#include <netcons.h>#include <dcdb.h>
#include <lsdceerr.h>     /* DSS only */
 
NetAppDel(pszTarget, pszUserID, pszAppname,
          reserved);                            /* 16 bit */  
 
Net32AppDel(pszTarget, pszUserID, pszAppname,
          reserved, pStatusbuf);    /* 32 bit */

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

pszTarget

null or \\servername

added to DCDB of a specified server when connected to a LAN Server or OS/2 LAN Server or OS/2 Warp Server.

//resdomname

added to resource domain of the local cell when connected to a DSS cell.

//resdomname@cellname

added to the resource domain of the specified cellname when connected to a DSS cell.

pszAppname

(unsigned char LSFAR *) points to an ASCIIZ string indicating the application to delete. For DSS the application name may be a global name.

reserved

(unsigned long) is reserved and must be set to 0.

pStatusbuf

must be NULL for OS/2 LAN Server and OS/2 Warp Server requests. For DSS may point to a buffer of size lsdce_err_stat_t (defined in lsdceerr.h). Contains specific DCE error information when NERR_DCEError is returned.

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 Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г ERROR_FILE_NOT_FOUND Г 2 Г The file was not found. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г ERROR_TOO_MANY_OPEN_FILES Г 4 Г The maximum number of open files was Г
Г Г Г exceeded. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г ERROR_ACCESS_DENIED Г 5 Г Administrator privilege is required. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г ERROR_NOT_ENOUGH_MEMORY Г 8 Г Sufficient memory is not available. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г ERROR_INVALID_DATA Г 13 Г The specified data is not valid. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г ERROR_INVALID_PARAMETER Г 87 Г At least one parameter value is not Г
Г Г Г valid. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_NetNotStarted Г 2102 Г The redirector NETWKSTA.200 has not been Г
Г Г Г started. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_BufTooSmall Г 2123 Г The buffer is too small for fixed-length Г
Г Г Г data. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_InvalidAPI Г 2142 Г The requested API is not supported on Г
Г Г Г the remote server. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_UserNotFound Г 2221 Г The user name cannot be found. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_DCDBError Г 2786 Г A domain control database file is Г
Г Г Г unreadable or cannot be accessed at this Г
Г Г Г time. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_AppNotFound Г 2793 Г The application to be deleted was not Г
Г Г Г found. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_NotPrimaryDCDB Г 2795 Г An attempt was made to access a domain Г
Г Г Г control database file on a machine that Г
Г Г Г is not the domain controller. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_DCEError Г 7500 Г DCE error status returned. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_DCEErrorLogged Г 7501 Г DCE error status has been logged. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_ResDomNotfound Г 7503 Г The specified resource domain does not Г
Г Г Г exist. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_InvalidObjGlobalName Г 7504 Г The specified object global name is not Г
Г Г Г valid. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_InvalidResDomName Г 7505 Г The specified resource domain name is Г
Г Г Г not valid. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_AuthTicketExpired Г 7511 Г The user's DCE authorization ticket has Г
Г Г Г expired. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_RegistryNotFound Г 7512 Г Unable to contact the DCE security reg- Г
Г Г Г istry. Г
РФФФФФФФФФФФФФФФФФФФФФФФФФФФСФФФФФФФСФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФй

Other codes could be returned from the following functions:

DosLoadModule
DosGetProcAddr

For information about:

Creating an application definition, see Application - NetAppAdd.
Listing application definitions, see Application - NetAppEnum.
Changing an application definition, see Application - NetAppSetInfo.
Listing applications that appear in folders on a particular user's desktop, see User - NetUserGetAppSel.
Changing the list of applications that appear in a particular user's desktop folder, see User - NetUserSetAppSel.

[Back]

[Next]