NetWkstaSetInfo
The NetWkstaSetInfo
function configures a workstation. This information remains in effect after the
system has been reinitialized.
Security Requirements
Only members
of the Administrators local group can successfully execute NetWkstaSetInfo
on a remote server.
NET_API_STATUS NetWkstaSetInfo(
|
LPTSTR servername, |
|
|
DWORD level, |
|
|
LPBYTE buffer, |
|
|
LPDWORD parm_err |
|
|
); |
|
Parameters
servername
Pointer to a
Unicode string containing the name of the remote server on which the function
is to execute. A NULL pointer or string specifies the local computer.
level
Specifies one
of the following values to set the level of information provided.
|
Value |
Meaning |
|
100 |
The buffer
parameter points to a WKSTA_INFO_100 structure. |
|
101 |
The buffer
parameter points to a WKSTA_INFO_101 structure. |
|
102 |
The buffer
parameter points to a WKSTA_INFO_102 structure. |
|
302 |
The buffer
parameter points to a WKSTA_INFO_302 structure. |
|
402 |
The buffer
parameter points to a WKSTA_INFO_402 structure. |
|
1101 |
The buffer
parameter points to a WKSTA_USER_INFO_11011Q9UGD1 structure. |
In addition,
the structures WKSTA_USER_INFO_502, WKSTA_USER_INFO_1010-1013, WKSTA_USER_INFO_1018,
WKSTA_USER_INFO_1023, WKSTA_USER_INFO_1027, WKSTA_USER_INFO_1028,
WKSTA_USER_INFO_1032, WKSTA_USER_INFO_1033, WKSTA_USER_INFO_1035,
and WKSTA_USER_INFO_1041-1062 should not be set by the
user.
buffer
Pointer to
the buffer in which the data set with the level parameter is stored.
parm_num
Determines
whether the buffer parameter contains a complete WKSTA_INFO_X
(where Xis the level) structure or a single structure component. If parm_num
is set to PARMNUM_ALL, buffer must point to a WKSTA_INFO_X
structure. Otherwise, only one element is changed, and parm_num must
point to the single element to change.
Not all
elements can be changed. Only those elements that have a specific PARMNUM
constant value defined can be set. The following possible values are defined.
|
Value |
Component
to Set |
|
PARMNUM_ALL |
All
elements |
|
WKSTA_CHARWAIT_PARMNUM |
wki0_charwait |
|
WKSTA_CHARTIME_PARMNUM |
wki0_chartime |
|
WKSTA_CHARCOUNT_PARMNUM |
wki0_charcount |
|
WKSTA_ERRLOGSZ_PARMNUM |
wki0_errlogsz |
|
WKSTA_PRINTBUFTIME_PARMNUM |
wki0_printbuftime |
|
WKSTA_WRKHEURISTICS_PARMNUM |
wki0_wrkheuristics |
|
WKSTA_OTHDOMAINS_PARMNUM |
wki1_oth_domains |
parm_err
Optional
pointer to a DWORD that contains the index of the first parameter that
causes ERROR_INVALID_PARAMETER. If NULL, the parameter is not returned on
error.
Remarks
You must be a
member of the Administrators local group to successfully execute NetWkstaSetInfo
on a remote server or on a computer that has local security enabled. NetWkstaSetInfo
does not change values in the LANMAN.INI file. Values set by previous calls to NetWkstaSetInfo
can be overwritten when workstation parameters are reset. When the Workstation
service is stopped and restarted, parameters are reset to the default values specified
in the LANMAN.INI file unless overwritten by command-line parameters.
Domain names
in the wki1_oth_domains member of the WKSTA_USER_INFO_1101 structure are separated by
spaces. An empty list is valid. A null pointer means to leave the member
unmodified. The wki1_oth_domains member cannot be set with MS-DOS. When
setting this element, NetWkstaSetInfo rejects the request if the name
list was invalid or if a name could not be added to one or more of the network
adapters managed by LAN Manager.
See Also