MprAdminInterfaceDeviceSetInfo

[This is preliminary documentation and subject to change.]

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

DWORD MprAdminInterfaceDeviceSetInfo(
  MPR_SERVER_HANDLE hMprServer,
  HANDLE hInterface,
  DWORD dwIndex,
  DWORD dwLevel,
  LPBYTE lplpBuffer
);

Parameters

hMprServer
[in] Handle to the Windows 2000 router on which to execute this call. Obtain this handle by calling MprAdminServerConnect.
hInterface
[in] Handle to the interface. Obtain this handle from a previous call to MprAdminInterfaceCreate, or by calling MprAdminInterfaceEnum.
dwIndex
[in] Specifies the one-based index of the device. A multi-linked demand-dial interface uses multiple devices.
dwLevel
[in] Specifies the level of the information pointed to by the lplpBuffer parameter.
lplpBuffer
[in] Pointer to an MPR_DEVICE_0 or MPR_DEVICE_1 structure that receives the information about the device. The dwLevel parameter specifies the type of structure.

Return Values

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 lplpbBuffer parameter is NULL.
ERROR_NOT_ENOUGH_MEMORY Insufficient resources to complete the operation.
ERROR_NOT_SUPPORTED The dwLevel value is invalid.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Header: Declared in Mprapi.h.
  Library: Use Mprapi.lib.

See Also

MPR_DEVICE_0, MPR_DEVICE_1, MprAdminInterfaceCreate, MprAdminInterfaceDeviceGetInfo