Функция MprAdminRegisterConnectionNotification (mprapi.h)

Функция MprAdminRegisterConnectionNotification регистрирует объект события с помощью диспетчера набора запросов (DDM), чтобы при подключении или отключении интерфейса событие подавалось.

Синтаксис

DWORD MprAdminRegisterConnectionNotification(
  [in] MPR_SERVER_HANDLE hMprServer,
  [in] HANDLE            hEventNotification
);

Параметры

[in] hMprServer

Дескриптор маршрутизатора, на котором выполняется этот вызов. Получите этот дескриптор, вызвав MprAdminServerConnect.

[in] hEventNotification

Дескриптор объекта события. Это событие подается при каждом подключении или отключении интерфейса.

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

Если функция выполнена успешно, возвращаемое значение будет NO_ERROR.

Если функция завершается сбоем, возвращается один из следующих кодов ошибок.

Значение Значение
ERROR_ACCESS_DENIED
 Вызывающее приложение не имеет достаточных привилегий.
ERROR_DDM_NOT_RUNNING
 Диспетчер вызова по запросу (DDM) не запущен.
ERROR_INVALID_PARAMETER
 Параметр hEventNotification имеет значение NULL или является недопустимым дескриптором.
Другое
 Используйте FormatMessage , чтобы получить системное сообщение об ошибке, соответствующее возвращаемому коду ошибки.
 
 

Комментарии

Событие подается при подключении или отключении интерфейса. Когда подается сигнал о событии, вызывающее приложение может определить, на какой интерфейс влияет, с помощью такой функции, как MprAdminConnectionEnum или MprAdminInterfaceEnum.

Требования

Требование Значение
Минимальная версия клиента Ни одна версия не поддерживается
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header mprapi.h
Библиотека Mprapi.lib
DLL Mprapi.dll

См. также раздел

FormatMessage

MprAdminConnectionEnum

MprAdminDeregisterConnectionNotification

MprAdminInterfaceEnum

Функции администрирования маршрутизатора

Справочник по управлению маршрутизаторами

  • Last updated on