NetAliasAdd or Net32AliasAdd

The NetAliasAdd API creates an alias definition.

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 NetAliasAdd requires one of the following:

The calling process has Administrator authority.
The calling process has server operator privilege.
If you are adding a print alias, the calling process has print operator privilege.
If you are adding a serial device alias, the calling process has comm operator privilege.

#include <netcons.h>#include <dcdb.h>
#include <lsdceerr.h>     /* DSS only */
 
NetAliasAdd(pszTarget, sLevel,
              buf, usBuflen);                /* 16 bit */
 
Net32AliasAdd(pszTarget, ulLevel,
              buf, ulBuflen, 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.

sLevel

ulLevel

Alias Level 2

For DSS, see Alias Level 2 or Alias Level 12.

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_LEVEL Г 124 Г The sLevel parameter is not valid. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г ERROR_BAD_PATHNAME Г 161 Г Path name not valid. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г 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_AliasExists Г 2782 Г The alias to be added already exists. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_DCDBError Г 2786 Г A domain control database is unreadable Г
Г Г Г or cannot be accessed at this time. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г 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. Г
РФФФФФФФФФФФФФФФФФФФФФФФФФФФСФФФФФФФСФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФй

Other codes could be returned from the following functions:

DosLoadModule
DosGetProcAddr

An alias that is created with an ai2_mode value of ALIAS_MODE_STARTUP is not shared by the NetAliasAdd API. Refer to Share - NetShareAdd for information about sharing resources.

For information about:

Listing all alias definitions, see Alias - NetAliasEnum.
Changing an alias definition, see Alias - NetAliasSetInfo.
Removing an alias definition, see Alias - NetAliasDel.
Automatically assigning aliases to a user at logon time, see User - NetUserGetLogonAsn and User - NetUserSetLogonAsn.

[Back]

[Next]