MprAdminInterfaceDeviceSetInfo function (mprapi.h)

  • Article

The MprAdminInterfaceDeviceSetInfo creates or modifies a device that is used in a router demand-dial interface.

Syntax

DWORD MprAdminInterfaceDeviceSetInfo(
  [in] MPR_SERVER_HANDLE hMprServer,
  [in] HANDLE            hInterface,
  [in] DWORD             dwIndex,
  [in] DWORD             dwLevel,
  [in] LPBYTE            lpbBuffer
);

Parameters

[in] hMprServer

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

[in] hInterface

Handle to the interface. Obtain this handle from a previous call to MprAdminInterfaceCreate, or by calling MprAdminInterfaceEnum.

[in] dwIndex

Specifies the one-based index of the device. A multi-linked demand-dial interface uses multiple devices.

[in] dwLevel

A DWORD value that describes the format in which the information is structured in the lplpBuffer parameter. Acceptable values for dwLevel include 0 or 1 as listed in the following table.

Value Structure Format
0 MPR_DEVICE_0
1 MPR_DEVICE_1

[in] lpbBuffer

A pointer to a MPR_DEVICE_0 or MPR_DEVICE_1 structure. The dwLevel parameter indicates the type of structure.

Return value

If the function succeeds, the return value is NO_ERROR.

If the function fails, the return value is one of the following error codes.

Value Meaning
ERROR_ACCESS_DENIED
 The calling application does not have sufficient privileges.
ERROR_INVALID_HANDLE
 The hInterface value is invalid.
ERROR_INVALID_PARAMETER
 The lplpBuffer parameter is NULL.
ERROR_NOT_ENOUGH_MEMORY
 Insufficient resources to complete the operation.
ERROR_NOT_SUPPORTED
 The dwLevel value is invalid.

Requirements

Requirement Value
Minimum supported client None supported
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header mprapi.h
Library Mprapi.lib
DLL Mprapi.dll

See also

MPR_DEVICE_0

MPR_DEVICE_1

MprAdminInterfaceCreate

MprAdminInterfaceDeviceGetInfo