NetAppSetInfo or Net32AppSetInfo

The NetAppSetInfo API changes information for 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 so be issued to an OS/2 Warp Server or Directory and Security Server workstation.

A successful call to NetAppSetInfo 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 setting information about the logged-on user's private applications.

#include <netcons.h>#include <dcdb.h>
#include <lsdceerr.h>     /* DSS only */
 
NetAppSetInfo(pszTarget, pszUserID, pszAppname, usLevel,
              buf, usBuflen, parmnum);    /* 16 bit */
 
Net32AppSetInfo(pszTarget, pszUserID, pszAppname, ulLevel,
              buf, ulBuflen, parmnum, 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 specifying the application for which information is to be changed. For DSS the application may be a global name.

sLevel

ulLevel

Application Information Level 1

Application Information Level 3

parmnum

sLevel

parmnum

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 ГThemaximumnumberofopenfileswas Г
Г Г Г 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_DRIVE Г 15 Г The specified drive is not valid. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г ERROR_BAD_LENGTH Г 24 Г The length is not valid. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г ERROR_ALREADY_ASSIGNED Г 85 Г Duplicate redirection. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г ERROR_INVALID_PARAMETER Г 87 Г The parmnum parameter is not valid. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г ERROR_INVALID_LEVEL Г 124 Г The sLevel parameter is not valid. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г ERROR_BAD_PATHNAME Г 161 Г Path name 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_AliasNotFound Г 2783 Г An alias specified in the input buffer Г
Г Г Г cannot be found. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_DCDBError Г 2786 Г A domain control database file is Г
Г Г Г unreadable or cannot be accessed at this Г
Г Г Г time. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_NotFound Г 2793 Г The application 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_BadAppRemark Г 2796 Г The application remark contains an error Г
Г Г Г or is not unique. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г 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. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_InvalidAliasNameFormaГ 7531 Г The syntax of the alias name is not Г
Г Г Г valid. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_IncompatibleLevel Г 7532 Г The level specified is incompatible for Г
Г Г Г this resource.. Г
РФФФФФФФФФФФФФФФФФФФФФФФФФФФСФФФФФФФСФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФй

Other codes could be returned from the following functions:

DosLoadModule
DosGetProcAddr

To delete an application's list data, call NetAppSetInfo at level 3 with app3_app_res_count set to 0.

LAN Server and Warp Server Only

When setting information about private applications, the domain control database subdirectories and files must exist for the user. The NetUserDCDBInit API can be used to initialize these subdirectories and files.

For information about:

Initializing a particular user's domain control database files, see User - NetUserDCDBInit.
Changing the list of applications that appear in a particular user's desktop application folders, see User - NetUserSetAppSel.
Retrieving information about a particular application definition, see Application - NetAppGetInfo.

[Back]

[Next]