Edit

Share via

IMbnMultiCarrier::GetCurrentCellularClass method (mbnapi.h)

  • Article

Important

Starting in Windows 10, version 1803, the Win32 APIs described in this section are replaced by the Windows Runtime APIs in the Windows.Networking.Connectivity namespace.

Gets the current cellular classes for a multi-carrier device.

Syntax

HRESULT GetCurrentCellularClass(
  [out, retval] MBN_CELLULAR_CLASS *currentCellularClass
);

Parameters

[out, retval] currentCellularClass

MBN_CELLULAR_CLASS

Pointer to an MBN_CELLULAR_CLASS enumeration that specifies the current cellular class. If this method returns any value other than S_OK, currentCellularClass is NULL. When GetCurrentCellularClass returns S_OK, the calling application must free the allocated memory by calling SafeArrayDestroy.

Return value

This method can return one of these values.

Return code Description
S_OK
 The method completed successfully.
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)
 The Mobile Broadband service is not running on this system.
E_HANDLE
 Invalid interface. The Mobile Broadband device has probably been removed from the system.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)
 Invalid interface. Most likely the Mobile Broadband device has been removed from the system.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)
 The operation is not supported by the device. This may be returned by devices which do not support multi-carrier.

Requirements

Requirement Value
Minimum supported client Windows 8 [desktop apps only]
Minimum supported server None supported
Target Platform Windows
Header mbnapi.h

See also

IMbnMultiCarrier