IMbnMultiCarrier::GetSupportedCellularClasses method (mbnapi.h)

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 list of supported cellular classes for a multi-carrier device.

Syntax

HRESULT GetSupportedCellularClasses(
  [out, retval] SAFEARRAY **cellularClasses
);

Parameters

[out, retval] cellularClasses

Pointer to an array of MBN_CELLULAR_CLASS enumerations that contain the list of supported cellular classes. If this method returns any value other than S_OK, cellularClass is NULL. When GetSupportedCellularClasses 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