|
| БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО! |
|
|
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
|
|
|
|
| |