Поделиться через

Функция обратного вызова RasAdminReleaseIpAddress

  • Статья

[Функция RasAdminReleaseIpAddress доступна для использования в Windows NT 4.0 и недоступна в последующих версиях. Вместо этого используйте MprAdminReleaseIpAddress.]

Функция RasAdminReleaseIpAddress — это определяемая приложением функция, экспортируемая библиотекой DLL администрирования сервера RAS стороннего производителя. RAS вызывает эту функцию, чтобы уведомить библиотеку DLL о том, что удаленный клиент отключен и что IP-адрес должен быть освобожден.

Синтаксис

void CALLBACK RasAdminReleaseIpAddress(
  _In_ WCHAR  *lpszUserName,
  _In_ WCHAR  *lpszPortName,
  _In_ IPADDR *pipAddress
);

Параметры

lpszUserName [in]

Указывает указатель на строку Юникода с завершением NULL, указывающую имя удаленного пользователя, ip-адрес которого ранее был получен с помощью функции RasAdminGetIpAddressForUser .

lpszPortName [in]

Указатель на строку Юникода, завершающуюся null, которая указывает имя порта, к которому подключен пользователь, указанный параметром lpszUserName .

pipAddress [in]

Указатель на переменную IPADDR , которая указывает IP-адрес, возвращенный этому пользователю при предыдущем вызове RasAdminGetIpAddressForUser.

Возвращаемое значение

Для этой функции нет расширенных сведений об ошибке; не вызывать GetLastError.

Комментарии

Сервер RAS вызывает функцию RasAdminReleaseIpAddress , только если приложение вернуло true в параметре bNotifyRelease во время предыдущего вызова RasAdminGetIpAddressForUser для пользователя, указанного параметром lpszUserName .

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

HKEY_LOCAL_MACHINE
   SOFTWARE
      Microsoft
         RAS
            AdminDll

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

Имя значения Данные
Отображаемое имя Строка REG_SZ , содержащая понятное отображаемое имя библиотеки DLL.
DLLPath Строка REG_SZ , содержащая полный путь к библиотеке DLL.

 

Например, запись реестра для библиотеки DLL администрирования RAS от вымышленной компании Pro Electronicsn, Inc. может выглядеть следующим образом:

HKEY_LOCAL_MACHINE
   SOFTWARE
      Microsoft
         RAS
            AdminDll

DisplayName: REG_SZ : Pro Electronicsn RAS Администратор DLLPath: REG_SZ : C:\nt\system32\ntwkadm.dll

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