IMbnServiceActivationEvents::OnActivationComplete method (mbnapi.h)

  • Article

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

See also

IMbnServiceActivationEvents