Функция MprAdminGetIpAddressForUser (mprapi.h)
RAS вызывает функцию MprAdminGetIpAddressForUser один раз для каждого пользователя, которому требуется IP-адрес. RAS вызывает функцию с IP-адресом, который RAS выбирает для пользователя. Сторонняя библиотека DLL, реализующая эту функцию, может изменить этот адрес на один из собственных вариантов.
Синтаксис
DWORD MprAdminGetIpAddressForUser(
[in] WCHAR *lpwszUserName,
[in] WCHAR *lpwszPortName,
[in, out] DWORD *lpdwIpAddress,
[out] BOOL *bNotifyRelease
);
Параметры
[in] lpwszUserName
Указатель на строку Юникода, указывающую имя пользователя, которому требуется IP-адрес.
[in] lpwszPortName
Указатель на строку Юникода, указывающую имя порта, к которому пользователь пытается подключиться.
[in, out] lpdwIpAddress
На входных данных указатель на переменную DWORD , содержащую ноль, или IP-адрес RAS, выделенный для пользователя.
В выходных данных, если RAS указывает ноль, библиотека DLL выделяет IP-адрес для пользователя. В этом случае, если библиотека DLL не выделяет IP-адрес, пользователь не сможет подключиться. Если RAS указывает IP-адрес, библиотека DLL принимает адрес или заменяет другой.
[out] bNotifyRelease
Указатель на переменную BOOL . Если библиотека DLL задает для этой переменной значение TRUE, RAS вызывает MprAdminReleaseIpAddress при отключении пользователя. В противном случае RAS не уведомляет библиотеку DLL о освобождении этого IP-адреса.
Возвращаемое значение
Если функция выполняется успешно, возвращаемое значение должно быть NO_ERROR.
Если функция возвращает что-либо, отличное от NO_ERROR, ras завершит подключение.
Комментарии
RAS поддерживает несколько библиотек DLL администрирования. Однако RAS вызывает MprAdminGetIpAddressForUser только в первой библиотеке DLL, которая реализует и экспортирует ее. RAS игнорирует реализации этих функций в других библиотеках DLL. RAS проверяет библиотеки DLL для этих функций в том порядке, в котором они перечислены в реестре.
Библиотека DLL администрирования не должна реализовывать функцию MprAdminGetIpAddressForUser . Однако если библиотека DLL реализует MprAdminGetIpAddressForUser, она также должна реализовывать MprAdminReleaseIpAddress.
Не вызывайте функции администрирования RAS или функции администрирования пользователей RAS из mprAdminGetIpAddressForUser. Вызовы этих функций не возвращаются при выполнении из функции выноски.
Требования
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | mprapi.h |