На главную

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 | Скачать Вниз

RasAdminGetIpAddressForUser



[New - Windows NT]

The RasAdminGetIpAddressForUser function is an application-defined function that is exported by a third-party RAS server administration DLL. RAS calls this function to get an IP address for the dialed-in remote client.

DWORD RasAdminGetIpAddressForUser(

WCHAR *lpszUserName, // pointer to the name of the remote user
WCHAR *lpszPortName, // pointer to the name of the port
IPADDR *pipAddress, // pointer to the IP address
BOOL *bNotifyRelease // indicates whether RAS should call RasAdminReleaseIpAddress
);


Parameters

lpszUserName

Pointer to a null-terminated Unicode string that contains the name of the remote user for whom an IP address is required.

lpszPortName

Pointer to a null-terminated Unicode string that contains the name of the port on which the user specified by lpszUserName is attempting to connect.

pipAddress

Pointer to an IPADDR variable. On input, *pipAddress contains either zero or the IP address that the RAS server proposes to use for the dialed-in remote client. The function can set *pipAddress to a different IP address, or accept the passed-in IP address. If *pipAddress is zero on input, the function must provide an IP address; otherwise, the client will be unable to connect to this server using IP.

bNotifyRelease

Pointer to a BOOL variable. Set this variable to TRUE if you want RAS to call your RasAdminReleaseIpAddress function when the user disconnects from this port; otherwise, set it to FALSE.



Return Values

If pipAddress points to an IP address that the client can use to connect to this RAS server, the function should return NO_ERROR. This can occur if the function accepts the IP address that was passed by the RAS server, or if the function provides a different IP address.
If pipAddress does not point to an IP address, the function should return a nonzero error code. This can occur if no IP address is available, or if the passed in IP address is unacceptable. In this case, the client will be unable to connect to this server using IP.

Remarks

The setup program for a third-party RAS administration DLL must register the DLL with RAS by providing information under the following key in the registry:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\RAS\AdminDll


To register the DLL, set the following values under this key.

Value Name Value Data
DisplayName A REG_SZ string that contains the user-friendly display name of the DLL.
DLLPath A REG_SZ string that contains the full path of the DLL.


For example, the registry entry for a RAS Administration DLL from a fictional company named Netwerks Corporation might be:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\RAS\AdminDll
DisplayName : REG_SZ : Netwerks RAS Admin DLL
DLLPath : REG_SZ : C:\nt\system32\ntwkadm.dll


The setup program for a RAS Administration DLL should also provide remove/uninstall functionality. If a user removes the DLL, the setup program should delete the DLL's registry entries.

See Also

RasAdminReleaseIpAddress


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

RasAdminGetIpAddressForUser



[Новый - Windows NT]

Функция RasAdminGetIpAddressForUser является определенной прикладной функцией, которая экспортирована независимой администрацией сервера RAS DLL. RAS НАЗЫВАЕТ эту функцию, чтобы получать адрес IP для коммутируемого-на дистанционном клиенте.

DWORD RasAdminGetIpAddressForUser(

WCHAR *lpszUserName, // УКАЗАТЕЛЬ в имя дистанционного пользователя WCHAR *lpszPortName, // указатель в имя порта IPADDR *pipAddress, // указатель в адрес IP BOOL *bNotifyRelease // указывает независимо RAS должен называть RasAdminReleaseIpAddress
);


Параметры

lpszUserName

Указатель в недействительный расторгнутую строку Уникода, которая содержит имя дистанционного пользователя для которого адрес IP потребовался.

lpszPortName

Указатель в недействительный расторгнутую строку Уникода, которая содержит имя порта на котором пользователь определенный lpszUserName пытается соединяться.

pipAddress

Указатель в переменную IPADDR. На вводе, *pipAddress содержит или нуль или адрес IP, что сервер RAS предлагает использоваться для коммутируемого-на дистанционном клиенте. Функция может установиться *pipAddress в другой адрес IP или приниматься прошедший-в адресе IP. Если *pipAddress - нуль на вводе, функция должна обеспечить адрес IP; в противном случае, клиент будет не в состоянии подключить к этому серверу, использовавшему IP.

bNotifyRelease

Указатель в переменную BOOL. Установите эту переменную в ИСТИНУ если Вы хотите, чтобы RAS называл вашу функцию RasAdminReleaseIpAddress когда пользователь отключает от этого порта; в противном случае, установившее это в ЛОЖЬ.



Обратные Величины

Если точки pipAddress на адрес IP, что клиент может использовать, чтобы подключать к этому серверу RAS, функция должна возвращать NO_ERROR. Это может произойти если функция принимает адрес IP, который был пройден сервером RAS, или если функция обеспечивает другой адрес IP.
Если pipAddress не указывает на адрес IP, функция должна возвращать ненулевой код ошибки. Это может произойти если никакой адрес IP не - доступен, или если прошедший в адресе IP неприемлемое. В этом случае, клиент будет не в состоянии подключить к этому серверу, использовавшему IP.

Замечания

Программа установки для независимой администрации RAS DLL должна зарегистрировать DLL с RAS обеспечивая информацию под следующей клавишей в регистрации:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\RAS\AdminDll


Для того, чтобы регистрировать DLL, установите следующее величин под этой клавишей.

Данные Величины Имени Величины
DisplayName СТРОКА REG_SZ, что содержит дружественное дисплейное имя DLL.
DLLPath СТРОКА REG_SZ, что содержит полный путь DLL.


Например, вход регистрации для RAS Administration DLL из фиктивной компании назвавшей Корпорацию Netwerks могло быть:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\RAS\AdminDll DisplayName : REG_SZ : Netwerks RAS Admin DLL DLLPath : REG_SZ : C:\nt\system32\ntwkadm.dll


Программа установки для RAS Administration DLL должна также обеспечить удаление/модифицировать функциональное назначение. Если пользователь удаляет DLL, программа установки должна удалить данные регистрации DLL's.

Смотри Также

RasAdminReleaseIpAddress


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