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.
Syntax

#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 */

Parameters

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

pszTarget

is a place holder you replace depending on whether you are connecting to an OS/2 LAN Server or DSS. The following are examples of each.

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 or ulLevel
(16-bit short or 32-bit unsigned long) can be 1, 2, or 3, specifying which data structure to use, as described in Application Information Level 1 through Application Information Level 3.
parmnum
(16-bit unsigned short or 32-bit unsigned long) specifies whether the entire data structure or only a specific field in the data structure is to be passed. If the value is 0, the entire data structure is sent and sLevel can be 1, 2, or 3. Otherwise, parmnum specifies which field in the data structure is to be sent. For this API, parmnum can be any one of the following: ЪДДДДДДДДДДДДДДДДДДДДДДДДДДДВДДДДДДДВДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДї
і SYMBOLIC CONSTANT і VALUE і COMPONENT і
ГДДДДДДДДДДДДДДДДДДДДДДДДДДДЕДДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДґ
і APP_REMARK_PARMNUM і 3 і appX_remark і
ГДДДДДДДДДДДДДДДДДДДДДДДДДДДЕДДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДґ
і APP_CMDLINE_PARMNUM і 4 і appY_command і
ГДДДДДДДДДДДДДДДДДДДДДДДДДДДЕДДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДґ
і APP_CMDPARMS_PARMNUM і 5 і appY_command_parms і
ГДДДДДДДДДДДДДДДДДДДДДДДДДДДБДДДДДДДБДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДґ
і NOTE: X can be 1, 2, or 3. Y can be 2 or 3. і
АДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДЩ

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.
Return Codes

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
Remarks

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.

Related Information

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]