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

Статья
08/24/2023

Функция MprAdminInterfaceConnect создает подключение к указанному интерфейсу глобальной сети.

Синтаксис

DWORD MprAdminInterfaceConnect(
  [in] MPR_SERVER_HANDLE hMprServer,
  [in] HANDLE            hInterface,
  [in] HANDLE            hEvent,
  [in] BOOL              fSynchronous
);

Параметры

[in] hMprServer

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

[in] hInterface

Дескриптор интерфейса. Этот дескриптор получен из предыдущего вызова MprAdminInterfaceCreate.

[in] hEvent

Обработка события, которое подается после завершения попытки подключения интерфейса. Функция инициирует попытку подключения и немедленно возвращается. После передачи сигнала о событии можно получить результат попытки подключения, вызвав mprAdminInterfaceGetInfo.

Если этот параметр имеет значение NULL, а fBlocking имеет значение TRUE, то этот вызов является синхронным, то есть функция не возвращается до завершения попытки подключения.

Вызывающее приложение должно указать значение NULL для этого параметра, если hMprServer указывает удаленный маршрутизатор.

[in] fSynchronous

Если hEvent имеет значение NULL и для этого параметра задано значение TRUE, функция не возвращается до завершения попытки подключения.

Если hEvent имеет значение NULL и этот параметр имеет значение FALSE, функция возвращается немедленно. Возвращаемое значение PENDING указывает, что попытка подключения была успешно инициирована.

Если hEvent не равно NULL, этот параметр игнорируется.

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

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

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

Значение	Значение
ERROR_ACCESS_DENIED	Вызывающее приложение не имеет достаточных привилегий.
ERROR_ALREADY_CONNECTING	Подключение к этому интерфейсу уже выполняется.
ERROR_DDM_NOT_RUNNING	Диспетчер набора запросов (DDM) не запущен.
ERROR_INTERFACE_DISABLED	Интерфейс в настоящее время отключен.
ERROR_INTERFACE_HAS_NO_DEVICES	Адаптеры для этого интерфейса недоступны.
ERROR_INVALID_HANDLE	Недопустимое значение hInterface .
ERROR_SERVICE_IS_PAUSED	Служба вызова по запросу в настоящее время приостановлена.
ОЖИДАЮЩИЕ	Интерфейс находится в процессе подключения. Вызывающее приложение должно ожидать дескриптора hEvent , если он указан. После передачи сигнала о событии можно получить состояние подключения и любые связанные ошибки, вызвав MprAdminInterfaceGetInfo.

hEvent	fBlocking	Результат
Дескриптор событий	Не учитывается	Вызов возвращается немедленно. Возвращаемое значение PENDING указывает, что попытка была успешно инициирована. Подождите hEvent. При получении сигнала hEvent используйте MprAdminInterfaceGetInfo , чтобы определить успешность или сбой попытки подключения.
NULL	TRUE	Вызов не возвращается до завершения попытки подключения.
NULL	FALSE	Вызов возвращается немедленно. Возвращаемое значение PENDING указывает, что попытка была успешно инициирована.

Требования


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