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]