MprAdminInterfaceTransportSetInfo

[This is preliminary documentation and subject to change.]

The MprAdminInterfaceTransportSetInfo function sets information for a transport running on an specified interface.

DWORD  MprAdminInterfaceTransportSetInfo(
  MPR_SERVER_HANDLE hMprServer,    // handle to router
  HANDLE hInterface,               // handle to interface
  DWORD dwTransportId,             // identifier for the transport
  LPBYTE pInterfaceInfo,           // interface information
  DWORD dwInterfaceInfoSize        // size of interface information
);

Parameters

hMprServer

Handle to the Windows NT router on which to execute this call. Obtain the handle by calling MprAdminServerConnect.

hInterface

Handle to the interface. Obtain this handle by calling MprAdminInterfaceCreate.

dwTransportId

Identifies the transport for which information will be set.

pInterfaceInfo

Pointer to the interface information for this transport.

dwInterfaceInfoSize

Specifies the size, in bytes, of the information pointed to by pInterfaceInfo.

Return Values

NO_ERROR

Information for the interface was set successfully.

ERROR_ACCESS_DENIED

The caller does not have sufficient privilege.

ERROR_INVALID_HANDLE

The hInterface value is invalid.

ERROR_INVALID_PARAMETER

The pInterfaceInfo parameter is NULL.

ERROR_NO_SUCH_INTERFACE

The specified transport is not running on the specified interface.

ERROR_UNKNOWN_PROTOCOL_ID

The dwTransportId value does not match any installed transport.

QuickInfo

  Windows NT: Use version 5.0 and later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in mprapi.h.
  Import Library: Link with mprapi.lib.

See Also

MprAdminInterfaceCreate, MprAdminServerConnect,

MprAdminInterfaceTransportGetInfo