IMbnServiceActivationEvents::OnActivationComplete method (mbnapi.h)

Article
10/13/2021

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.

Notification method called by the Mobile Broadband service to indicate that a service activation request ahs completed.

Syntax

HRESULT OnActivationComplete(
  [in] IMbnServiceActivation *serviceActivation,
  [in] SAFEARRAY             *vendorSpecificData,
  [in] ULONG                 requestID,
  [in] HRESULT               status,
  [in] ULONG                 networkError
);

Parameters

[in] serviceActivation

Pointer to an IMbnServiceActivation interface representing the device on which the request was performed.

[in] vendorSpecificData

A byte array containing the data returned by the underlying Mobile Broadband miniport driver in NDIS_STATUS_WWAN_SERVICE_ACTIVATION.

[in] requestID

The request ID assigned by the Mobile Broadband service when the request was initialized.

[in] status

The completion status.

A calling application can expect one of the following values.

Value	Meaning
S_OK	The operation was successful.
E_INVALIDARG	The miniport driver detected incorrect input data in the request.
E_MBN_PIN_REQUIRED	A PIN is required for the operation to complete.
E_MBN_RADIO_POWER_OFF	The Mobile Broadband device is not powered up.
E_MBN_PROVIDER_NOT_VISIBLE	The service provider is not visible.
E_MBN_SIM_NOT_INSERTED	There is no SIM in the device.
E_MBN_BAD_SIM	There is a bad SIM in the device.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	The device does not support this operation.

[in] networkError

The error code returned by the network during the activation operation. This value is meaningful only when status is not S_OK.

The exact value of networkError is driver/network dependent.

Return value

This method must return S_OK.

Remarks

Successful service activation will also result in a change to the ready state of the device. the Mobile Broadband service will call the OnReadyStateChange method of IMbnInterfaceEvents as notification.

Requirements

Requirement	Value
Minimum supported client	Windows 7 [desktop apps only]
Minimum supported server	None supported
Target Platform	Windows
Header	mbnapi.h