IMbnInterface::GetSubscriberInformation method

Gets the subscriber information.


HRESULT GetSubscriberInformation(
  [out, retval] IMbnSubscriberInformation **subscriberInformation


subscriberInformation [out, retval]

A pointer to the address of an IMbnSubscriberInformation interface that contains subscriber information for the device. If this method returns any value other than S_OK, this parameter is NULL.

Return value

This method can return one of these values.

Return codeDescription

The method completed successfully. subscriberInformation contains a valid interface.


The information is not available. The Mobile Broadband service is currently probing for the information. The calling application can get notified when the information is available by registering for the OnSubscriberInformationChange method of IMbnInterfaceEvents.



The GetSubscriberInformation method returns the subscriber-related information, including subscriber ID, SIM international circuit card number, and phone numbers associated with this interface.

When this method is called from a Windows Store app with mobile operator privileges it will only return the SIM International circuit card number defined by the SimIccID property.

Some of the values returned in subscriber information are populated only when the ready state which as reported by the GetReadyState method of IMbnInterface is MBN_READY_STATE_INITIALIZED. Whenever there is a change in the subscriber information associated with the Mobile Broadband device, the Mobile Broadband service will notify registered applications by calling the OnSubscriberInformationChange method of IMbnInterfaceEvents.

Subscriber information for a device will not change once the device ready state is MBN_READY_STATE_INITIALIZED.


Minimum supported client

Windows 7 [desktop apps | Windows Store apps]

Minimum supported server

None supported



See also