| UID | title | description | helpviewer_keywords | old-location | tech.root | ms.assetid | ms.date | ms.keywords | req.header | req.include-header | req.target-type | req.target-min-winverclnt | req.target-min-winversvr | req.kmdf-ver | req.umdf-ver | req.ddi-compliance | req.unicode-ansi | req.idl | req.max-support | req.namespace | req.assembly | req.type-library | req.lib | req.dll | req.irql | targetos | req.typenames | req.redist | ms.custom | f1_keywords | dev_langs | topic_type | api_type | api_location | api_name | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
NF:mbnapi.IMbnMultiCarrier.SetHomeProvider |
IMbnMultiCarrier::SetHomeProvider (mbnapi.h) |
Updates the home provider for a multi-carrier device. |
|
mbn\imbnmulticarrier_sethomeprovider.htm |
mbn |
9FDC1B01-4768-4621-9B0E-6EC9AB4275A9 |
12/05/2018 |
IMbnMultiCarrier interface [Microsoft Broadband Networks],SetHomeProvider method, IMbnMultiCarrier.SetHomeProvider, IMbnMultiCarrier::SetHomeProvider, SetHomeProvider, SetHomeProvider method [Microsoft Broadband Networks], SetHomeProvider method [Microsoft Broadband Networks],IMbnMultiCarrier interface, mbn.imbnmulticarrier_sethomeprovider, mbnapi/IMbnMultiCarrier::SetHomeProvider |
mbnapi.h |
Windows |
Windows 8 [desktop apps only] |
None supported |
Mbnapi.idl |
Windows |
19H1 |
|
|
|
|
|
|
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.
Updates the home provider for a multi-carrier device.
An MBN_PROVIDER2 structure that contains the home provider.
The SignalStrength and SignalError members must be 0.
A pointer to the request ID set by the operating system for this request. The asynchronous response from OnSetHomeProviderComplete will contain this same requestID.
Pointer to the request ID set by the operating system for this request. The asynchronous response will contain this same requestID.
This method can return one of these values.
| Return code | Description |
|---|---|
|
The method completed successfully. |
|
The Mobile Broadband service is not running on this system. |
|
Invalid interface. The Mobile Broadband device has probably been removed from the system. |
|
Invalid interface. Most likely the Mobile Broadband device has been removed from the system. |
|
The operation is not supported by the device. This may be returned by devices which do not support multi-carrier. |
The SetHomeProvider method initiates an update of the home provider for the interface. This is an asynchronous operation, and the method call returns immediately. If this method returns successfully with S_OK, then Windows will notify the calling application about the completion status of this operation by calling the OnSetHomeProviderComplete method of IMbnMultiCarrierEvents.
The device will then automatically come up registered to the new network and indicate a registration state change. The device will continue to come up registered to this new home network across Windows reboots unless SetHomeProvider is used again to set a new home provider.
If the device is removed from the system before this operation is complete, there is no guarantee that the completion notification will be received by the calling application.