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

Статья
08/24/2023

Функция MprConfigTransportGetHandle извлекает дескриптор в конфигурацию указанного транспортного протокола в указанной конфигурации маршрутизатора.

Синтаксис

DWORD MprConfigTransportGetHandle(
  [in]  HANDLE hMprConfig,
  [in]  DWORD  dwTransportId,
  [out] HANDLE *phRouterTransport
);

Параметры

[in] hMprConfig

Обработка конфигурации маршрутизатора. Дескриптор получен из предыдущего вызова MprConfigServerConnect.

[in] dwTransportId

Значение DWORD , описывающее тип дескриптора конфигурации транспорта в параметре phRouterTransport . Допустимые значения для dwTransportId перечислены в следующей таблице.

Значение	Транспорт (семейство протоколов)
PID_ATALK	Appletalk
PID_IP	Интернет-протокол версии 4
PID_IPX	Обмен пакетами через Интернет
PID_NBF	Протокол кадров NetBIOS
PID_IPV6	Windows Server 2008 или более поздней версии: протокол Internet Protocol версии 6

[out] phRouterTransport

Указатель на
Переменная HANDLE, получающая тип дескриптора конфигурации транспорта, указанный в параметре dwTransportId.

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

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

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

Значение	Значение
ERROR_INVALID_PARAMETER	Параметр hMprConfig и (или) параметр phRouterTransport имеет значение NULL.
ERROR_NOT_ENOUGH_MEMORY	Недостаточно ресурсов для завершения операции.
ERROR_UNKNOWN_PROTOCOL_ID	Транспортный протокол, указанный dwTransportId , не найден в конфигурации маршрутизатора.
Другое	Используйте FormatMessage , чтобы получить системное сообщение об ошибке, соответствующее возвращаемому коду ошибки.

Требования

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

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

FormatMessage

MprConfigServerConnect

Функции конфигурации маршрутизатора

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

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