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

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

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.
sLevel or ulLevel
(16-bit short or 32-bit unsigned long) must be 2 for OS/2 LAN Server, and OS/2 Warp Server, which specifies the data structure described in 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.
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 │ 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
Remarks

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.

Related Information

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: Alias Level 12]
[Next: NetAliasDel or Net32AliasDel]