На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

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_1101 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

NetWkstaGetInfo


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

NetWkstaSetInfo



Функция NetWkstaSetInfo конфигурирует рабочую станцию. Эта информация остается в силе после того, как система будет инициализирована вновь.

Требования Безопасности

Только участники локальной группы Администраторов могут успешно выполнить NetWkstaSetInfo в дистанционном сервере.

NET_API_STATUS NetWkstaSetInfo(

LPTSTR servername, УРОВЕНЬ DWORD, буфер LPBYTE, parm_err LPDWORD
);


Параметры

servername

Указатель в строку Уникода, содержащую имя дистанционного сервера на котором функция должна выполняться. НЕДЕЙСТВИТЕЛЬНЫЙ указатель или строка определяет локальный компьютер.

уровень

Определяет одно из следующего величин, чтобы устанавливать уровень предусмотренной информации.

Значение Величины
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_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, и WKSTA_USER_INFO_1041-1062 не должны устанавливаны пользователем.

буфер

Указатель в буфер в котором данные установленные параметром уровня загружены.

parm_num

Определяет содержит буферный параметр полной WKSTA_INFO_X структуры (где Xis уровень) или единственный структурный компонент. Если parm_num установлен на PARMNUM_ALL, буфер должен указать на структуру WKSTA_INFO_X. В противном случае, только один элемент измениться, и parm_num должно указать на единственный элемент, чтобы изменяться.
Не все элементы могут быть измениться. Только те элементы, которые имеют специфическую постоянную величину PARMNUM определенную может быть установлено. Следующие возможные величины определены.

Компонент Величины, чтобы Устанавливать PARMNUM_ALL Всех элементов 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 wki1_oth_domains wki0_wrkheuristics WKSTA_OTHDOMAINS_PARMNUM


parm_err

Дополнительный указатель на DWORD, которое содержит индекс первого параметра, который вызывает ERROR_INVALID_PARAMETER. Если НЕДЕЙСТВИТЕЛЬНО, параметр не возвращан на ошибку.



Замечания

Вы должны быть элемент локальной группы Администраторов, чтобы успешно выполнять NetWkstaSetInfo в дистанционном сервере или в компьютере, что приспособился локальную безопасность. NetWkstaSetInfo НЕ изменяет величины в файле LANMAN.INI. Величины установленные предшествующими вызовами на NetWkstaSetInfo могут быть переписаны когда параметры рабочей станции восстановлены. Когда услуга Рабочей станции остановлена и перезапущена, параметры восстановлены в значение по умолчанию определенное в файле LANMAN.INI если не переписано командной строкой параметров.

Доменные имена в wki1_oth_domains элементе структуры WKSTA_USER_INFO_1101 разделены пробелами. Пустой список в силе. Недействительный указатель хочет оставлять unmodified элемент. wki1_oth_domains Элемент не может быть установлен МС-DOS. При установке этого элемента, NetWkstaSetInfo отвергает запрос если список имени был недействителен или если имя не могло добавлено к одному или более из сетевых адаптеров управляемых Менеджером LAN.

Смотри Также

NetWkstaGetInfo


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz