Функция MprConfigInterfaceTransportGetHandle (mprapi.h)
Функция MprConfigInterfaceTransportGetHandle извлекает дескриптор в конфигурацию транспорта интерфейса в указанной конфигурации маршрутизатора.
Синтаксис
DWORD MprConfigInterfaceTransportGetHandle(
[in] HANDLE hMprConfig,
[in] HANDLE hRouterInterface,
[in] DWORD dwTransportId,
[out] HANDLE *phRouterIfTransport
);
Параметры
[in] hMprConfig
Обработка конфигурации маршрутизатора. Получите этот дескриптор, вызвав MprConfigServerConnect.
[in] hRouterInterface
Обработка конфигурации интерфейса. Получите этот дескриптор, вызвав MprConfigInterfaceCreate, MprConfigInterfaceGetHandle или MprConfigInterfaceEnum.
[in] dwTransportId
Значение DWORD , описывающее тип дескриптора конфигурации транспорта в параметре phRouterIfTransport . Допустимые значения для dwTransportId перечислены в следующей таблице.
Значение | Транспорт (семейство протоколов) |
---|---|
PID_ATALK | Appletalk |
PID_IP | Интернет-протокол версии 4 |
PID_IPX | Обмен пакетами через Интернет |
PID_NBF | Протокол кадров NetBIOS |
PID_IPV6 | Windows Server 2008 или более поздней версии: протокол Internet Protocol версии 6 |
[out] phRouterIfTransport
Указатель на
Переменная HANDLE, которая получает тип дескриптора конфигурации транспорта для этого интерфейса, указанный в параметре dwTransportId.
Возвращаемое значение
Если функция выполнена успешно, возвращаемое значение будет NO_ERROR.
Если функция завершается сбоем, возвращается один из следующих кодов ошибок.
Значение | Значение |
---|---|
|
Хотя бы одно из следующих утверждений верно:
|
|
Недостаточно ресурсов для завершения операции. |
|
Интерфейс, указанный hRouterInterface , не найден в конфигурации маршрутизатора, или транспорт, заданный dwTransportId , не был включен в указанном интерфейсе. |
|
Используйте FormatMessage , чтобы получить системное сообщение об ошибке, соответствующее возвращаемому коду ошибки. |
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Ни одна версия не поддерживается |
Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
Целевая платформа | Windows |
Header | mprapi.h |
Библиотека | Mprapi.lib |
DLL | Mprapi.dll |