IMbnInterfaceEvents::OnScanNetworkComplete method

This notification method is called by the Mobile Broadband service to indicate the completion of a network scan.

Syntax

HRESULT OnScanNetworkComplete(
  [in] IMbnInterface *newInterface,
  [in] ULONG         requestID,
  [in] HRESULT       status
);

Parameters

newInterface [in]

An IMbnInterface that represents a device on which this operation was performed.

requestID [in]

The request ID assigned by the Mobile Broadband service for this notification.

status [in]

The operation completion status

.

A calling application can expect one of the following values.

S_OK (The operation was successful.)

E_MBN_RADIO_POWER_OFF (Can't get a visible network list because the device radio is off. The application can issue a network scan request when it gets the radio-turned-on notification.)

E_MBN_DEVICE_BUSY (The device is busy and can't currently perform a network scan operation. This is returned by devices which don't support a network scan operation when it has a data connection established.)

E_MBN_ALREADY_ACTIVE (A network scan operation is already in progress.)

Return value

This method must return S_OK.

Remarks

If the operation completed successfully, that is, when status is S_OK, the Mobile Broadband service successfully updated the cached list of visible providers. An application can then call the GetVisibleProviders method of the passed IMbnInterface to get the list of visible providers.

If multiple applications registered for notifications, then this method will be called on all registered applications. This means that an application that did not initiate the update operation will receive a notification.

Requirements

See also

IMbnInterfaceEvents