IMbnRegistration::GetProviderName method (mbnapi.h)

Gets the provider name for the currently registered network.

Syntax

HRESULT GetProviderName(
  [out] BSTR *providerName
);

Parameters

[out] providerName

Pointer to a string that contains the name of the currently registered provider. The maximum length of this string is MBN_PROVIDERNAME_LEN characters. The string is filled only when the method returns S_OK for success. Upon success, the calling application must free the allocated memory by calling SysFreeString.

Return value

This method can return one of these values.

Remarks

The provider name may change when the Mobile Broadband device moves from one network to another. This includes whenever there is change from MBN_REGISTER_STATE_HOME to MBN_REGISTER_STATE_SEARCHING in the network registration state. This also occurs when there is a change in the registered network, such as when a network changes its registration from one provider to another. After such changes, the Mobile Broadband service will call the OnRegisterStateChange method of IMbnRegistrationEvents. When this happens, the application should call GetProviderID.

For the recoverable error E_MBN_PIN_REQUIRED, the Mobile Broadband service will try to refetch this information from the device when the error condition is over (when a PIN is entered). Then it will call the OnRegisterStateChange method of IMbnRegistrationEvents.

Requirements

See also

IMbnRegistration