NetWkstaSetInfo or Net32WkstaSetInfo

The NetWkstaSetInfo API configures a requester.

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. Administrator authority is required only for remote users to call this API. No access authority is required for local execution.

The fields wki0_computername and wki0_langroup cannot be set by users or administrators.

The values of the wksta_info data structure are separated by spaces. An empty list is valid. (As usual, a NULL pointer indicates that the field should not be changed.) An empty element, however, is not valid.

The NetWkstaSetInfo API rejects attempts to change oth_domains in the following cases:

• The name list was incorrect.
  
• One of the names could not be added to the network adapters managed by LAN Server.
Syntax

#include <netcons.h>#include <wksta.h>
 
NetWkstaSetInfo(pszServername, sLevel, buf,
                usBuflen, parmnum);            /* 16 bit */
 
Net32WkstaSetInfo(pszServername, ulLevel, buf,
                ulBuflen, parmnum);          /* 32 bit */

Parameters

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

sLevel or ulLevel

(16-bit short or 32-bit unsigned long) can be 0 or 1, specifying which data structure to use, as described in Requester Data Structures.
parmnum
(16-bit 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. Otherwise, parmnum specifies which field in the data structure is to be sent. If not 0, parmnum can be any one of the following: ┌──────────────────────────────┬─────┬─────────────────────────────────────────┐
│ SYMBOLIC CONSTANT │ VALU│ FIELD TO BE PASSED │
├──────────────────────────────┼─────┼─────────────────────────────────────────┤
│ WKSTA_CHARWAIT_PARMNUM │ 10 │ wkiX_charwait │
├──────────────────────────────┼─────┼─────────────────────────────────────────┤
│ WKSTA_CHARTIME_PARMNUM │ 11 │ wkiX_chartime │
├──────────────────────────────┼─────┼─────────────────────────────────────────┤
│ WKSTA_CHARCOUNT_PARMNUM │ 12 │ wkiX_charcount │
├──────────────────────────────┼─────┼─────────────────────────────────────────┤
│ WKSTA_ERRLOGSZ_PARMNUM │ 27 │ wkiX_errlogsz │
├──────────────────────────────┼─────┼─────────────────────────────────────────┤
│ WKSTA_PRINTBUFTIME_PARMNUM │ 28 │ wkiX_printbuftime │
├──────────────────────────────┼─────┼─────────────────────────────────────────┤
│ WKSTA_WRKHEURISTICS_PARMNUM │ 32 │ wkiX_wrkheuristics │
├──────────────────────────────┼─────┼─────────────────────────────────────────┤
│ WKSTA_OTHDOMAINS_PARMNUM │ 35 │ wkiY_oth_domains │
├──────────────────────────────┴─────┴─────────────────────────────────────────┤
│ NOTE: │
│ │
│ X = 0 or 1 │
│ Y = 1 │
└──────────────────────────────────────────────────────────────────────────────┘

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 │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_Success │ 0 │ No errors were encountered. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ ERROR_ACCESS_DENIED │ 5 │ Administrator privilege is required. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ ERROR_BAD_NETPATH │ 53 │ The network path cannot be found. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ ERROR_INVALID_PARAMETER │ 87 │ At least one parameter value is not │
│ │ │ valid. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ ERROR_INVALID_LEVEL │ 124 │ The sLevel parameter is not valid. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ ERROR_MORE_DATA │ 234 │ Additional data is available, but the │
│ │ │ buffer is too small. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_NetNotStarted │ 2102 │ The redirector NETWKSTA.200 has not │
│ │ │ been started. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_BufTooSmall │ 2123 │ The buffer is too small for fixed- │
│ │ │ length data. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_NetworkError │ 2136 │ A general network error has occurred. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_WkstaNotStarted │ 2138 │ The Requester service has not been │
│ │ │ started. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_InternalError │ 2140 │ An internal error has occurred. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_BadTransactConfig │ 2141 │ The server is not configured for │
│ │ │ transactions. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_TooManyNames │ 2277 │ The maximum number of added message │
│ │ │ aliases has been exceeded. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_DuplicateName │ 2297 │ A duplicate message alias exists on │
│ │ │ the local area network. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_InvalidComputer │ 2351 │ The specified computer name is not │
│ │ │ valid. │
└─────────────────────────────┴───────┴────────────────────────────────────────┘


Other codes could be returned from the following functions:

• DosDevIOCtl
  
• DosFsCtl
  
• DosGetShrSeg
Related Information

For information about retrieving the configuration of a local requester, see Requester - NetWkstaGetInfo.

---

[Back: NetWkstaGetInfo or Net32WkstaGetInfo]
[Next: RIPL Category]