IMbnRegistration::GetRoamingText method (mbnapi.h)

Gets the roaming text describing the roaming provider.

Syntax

HRESULT GetRoamingText(
  [out] BSTR *roamingText
);

Parameters

[out] roamingText

Pointer to a string that contains additional information about a network with which the device is roaming. The maximum length is MBN_ROAMTEXT_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 GetRoamingText method can get a text string containing additional information about the network when the registration state is either MBN_REGISTER_STATE_PARTNER or MBN_REGISTER_STATE_ROAMING.

This information may change when the Mobile Broadband device moves from one network to another. This includes whenever there is a 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 moves its registration from one provider to another. After such changes, the Mobile Broadband service will call the OnRegisterStateChange method of IMbnRegistrationEvents.

For the recoverable error E_MBN_PIN_REQUIRED, the Mobile Broadband service will again try to fetch 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