IMbnSmsEvents::OnSetSmsConfigurationComplete method (mbnapi.h)

Article
02/22/2024

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 signaling that a set SMS configuration operation has completed, or that the SMS subsystem is initialized and ready for operation.

Syntax

HRESULT OnSetSmsConfigurationComplete(
  [in] IMbnSms *sms,
  [in] ULONG   requestID,
  [in] HRESULT status
);

Parameters

[in] sms

A pointer to an IMbnSms interface representing the Mobile Broadband device for which the SMS configuration has been updated.

[in] requestID

A request ID assigned by the Mobile Broadband service to identify the operation.

[in] status

A status code that indicates the outcome of the operation.

A calling application can expect one of the following values.

Value	Meaning
S_OK	The operation was successful.
E_MBN_SIM_NOT_INSERTED	There is no SIM in the device.
E_MBN_BAD_SIM	There is a bad SIM in the device.
E_MBN_PIN_REQUIRED	A PIN is required for the operation to complete.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	The SMS format is not supported by the device.

Return value

This method must return S_OK.

Remarks

This method is used to notify an application of the completion of a set SMS configuration operation. The application can use the passed IMbnSms interface to get the new configuration information. It is also used by the device to indicate the readiness of the device's SMS subsystem. Upon system startup or device insertion, this method will be called to notify applications that the device SMS subsystem is ready for operation.

Requirements

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