функция обратного вызова PREGISTER_PROTOCOL (routprot.h)
Функция RegisterProtocol регистрирует протокол маршрутизации в диспетчере маршрутизатора. Он также информирует диспетчера маршрутизатора о функциональных возможностях, поддерживаемых протоколом маршрутизации.
Синтаксис
PREGISTER_PROTOCOL PregisterProtocol;
DWORD PregisterProtocol(
[in, out] PMPR_ROUTING_CHARACTERISTICS pRoutingChar,
[in, out] PMPR_SERVICE_CHARACTERISTICS pServiceChar
)
{...}
Параметры
[in, out] pRoutingChar
На входных данных указатель на структуру MPR_ROUTING_CHARACTERISTICS .
В выходных данных получает указатели на функции, реализованные для протокола маршрутизации.
Дополнительные сведения о том, как использовать ее с функцией RegisterProtocol, см. на странице справочника по структуре MPR_ROUTING_CHARACTERISTICS.
[in, out] pServiceChar
На входных данных указатель на структуру MPR_SERVICE_CHARACTERISTICS .
В выходных данных получает указатели на функции, реализованные для протокола маршрутизации.
Дополнительные сведения о том, как использовать ее с функцией RegisterProtocol, см. на странице справочника по структуре MPR_SERVICE_CHARACTERISTICS.
Возвращаемое значение
Если функция выполнена успешно, возвращаемое значение будет NO_ERROR.
Если функция завершается сбоем, возвращаемое значение будет ERROR_NOT_SUPPORTED.
Комментарии
Все библиотеки DLL протокола маршрутизации должны заполнять значения для структуры MPR_ROUTING_CHARACTERISTICS .
Библиотеки DLL протокола маршрутизации, предоставляющие службы, должны заполнять значения для структуры MPR_SERVICE_CHARACTERISTICS . Если библиотека DLL протокола маршрутизации не предоставляет служб, она должна заполнять ноль для элемента fSupportedFunctionality этой структуры, но не заполнять значения для других членов.
Протоколы маршрутизации реализуются в библиотеках DLL пользовательского режима. Одна библиотека DLL может реализовывать несколько протоколов маршрутизации. Таким образом, диспетчер маршрутизатора может вызывать RegisterProtocol несколько раз, по одному разу для каждого протокола маршрутизации, реализованного в библиотеке DLL.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Ни одна версия не поддерживается |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | routprot.h |