NetWkstaSetInfo功能配置工作站。该信息在系统重新初始化后仍然有效。
安全要求
只有管??理员本地组的成员才能在远程服务器上成功执行NetWkstaSetInfo.
NET_API_STATUS NetWkstaSetInfo
LPTSTR【服务器名称】, | |
DWORD【水平】, | |
LPBYTE【缓冲】, | |
LPDWORD【parm_err】 | |
); |
参数
【服务器名称】
指向包含要执行该函数的远程服务器名称的Unicode字符串。NULL指针或字符串指定本地计算机。
【水平】
指定以下值之一来设置提供的信息级别。
值 | 含义 |
100 | 【缓冲】参数指向WKSTA_INFO_100结构。 |
101 | 【缓冲】参数指向WKSTA_INFO_101结构。 |
102 | 【缓冲】参数指向WKSTA_INFO_102结构。 |
302 | 【缓冲】参数指向WKSTA_INFO_302结构。 |
402 | 【缓冲】参数指向WKSTA_INFO_402结构。 |
1101 | 【缓冲】参数指向WKSTA_USER_INFO_1101结构。 |
另外,结构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和WKSTA_USER_INFO_1041 【-】 {989796106 }不应由用户设置。
【缓冲】
指向存储有【水平】参数的数据的缓冲区的指针。
【parm_num】
确定【缓冲】参数是否包含完整的WKSTA _ INFO _ 【X】(其中【X】是级别)结构或单个结构组件。如果【parm_num】设置为PARMNUM_ALL,则【缓冲】必须指向WKSTA _ INFO_X结构。否则,只有一个元素被更改,【parm_num】必须指向要更改的单个元素。
并非所有元素都可以更改。只能定义具有特定PARMNUM常量值的元素。定义了以下可能的值。
值 | 组件设置 |
PARMNUM_ALL | 所有元素 |
WKSTA_CHARWAIT_PARMNUM | wki0_charwaitcy |
WKSTA_CHARTIME_PARMNUM | wki0_chartimeenen |
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】
可选的指向DWORD的指针,其中包含导致ERROR_INVALID_PARAMETER的第一个参数的索引。如果为NULL,则不返回错误的参数。
备注
您必须是Administrators本地组的成员才能在远程服务器或启用了本地安全性的计算机上成功执行NetWkstaSetInfo.NetWkstaSetInfo不更改LANMAN.INI文件中的值。当复位工作站参数时,以前调用NetWkstaSetInfo设置的值可能会被覆盖。当Workstation服务停止并重新启动时,参数将重置为LANMAN.INI文件中指定的默认值,除非被命令行参数覆盖。
WKSTA_USER_INFO_1101 WKSTA_USER_INFO_1101结构中的域名由空格分隔。空列表有效。空指针意味着不修改成员。无法使用MS-DOS设置wki1_oth_domains成员。设置此元素时,如果名称列表无效或无法将名称添加到LAN Manager管理的一个或多个网络适配器中,NetWkstaSetInfo将拒绝该请求。
也可以看看