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

Статья
03/15/2023

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

Синтаксис

DWORD MprAdminTransportSetInfo(
  [in]           MPR_SERVER_HANDLE hMprServer,
  [in]           DWORD             dwTransportId,
  [in, optional] LPBYTE            pGlobalInfo,
  [in]           DWORD             dwGlobalInfoSize,
  [in, optional] LPBYTE            pClientInterfaceInfo,
  [in]           DWORD             dwClientInterfaceInfoSize
);

Параметры

[in] hMprServer

Дескриптор маршрутизатора, для которого задана информация. Этот дескриптор получен из предыдущего вызова MprAdminServerConnect.

[in] dwTransportId

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

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

[in, optional] pGlobalInfo

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

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

[in] dwGlobalInfoSize

Указывает размер (в байтах) буфера, на который указывает параметр pGlobalInfo .

[in, optional] pClientInterfaceInfo

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

Этот параметр является необязательным. Если вызывающее приложение задает значение NULL для этого параметра, функция не задает сведения об интерфейсе клиента по умолчанию.

[in] dwClientInterfaceInfoSize

Задает размер (в байтах) буфера, на который указывает параметр pClientInterfaceInfo .

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

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

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

Значение	Значение
ERROR_ACCESS_DENIED	Вызывающее приложение не имеет достаточных привилегий.
ERROR_INVALID_PARAMETER	Параметр pGlobalInfo и параметр pClientInterfaceInfo имеют значение NULL.
ERROR_NOT_ENOUGH_MEMORY	Недостаточно ресурсов для завершения операции.
ERROR_UNKNOWN_PROTOCOL_ID	Значение dwTransportId не соответствует ни одному поддерживаемому протоколу транспорта.

Требования


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

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

MprAdminServerConnect

MprAdminTransportGetInfo

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

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

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