OID_WWAN_HOME_PROVIDER
OID_WWAN_HOME_PROVIDER is used to set and retrieve information about the home provider of the cellular service subscription. For GSM-based devices and CDMA-based device with U-RIM, this information should be stored on the Subscriber Identity Module (SIM card). For CDMA-based devices without U-RIM, this information should be stored in auxiliary device memory.
Windows 8 supports both set and query requests. Windows 7 supports only query requests.
Miniport drivers must process both set and query requests asynchronously, initially returning NDIS_STATUS_INDICATION_REQUIRED to the original request and later sending a NDIS_STATUS_WWAN_HOME_PROVIDER status notification, for a query, or NDIS_STATUS_WWAN_SET_HOME_PROVIDER_COMPLETE status notification, for set, containing an NDIS_WWAN_HOME_PROVIDER structure to return information about the home network provider with the Provider.ProviderState member of the NDIS_WWAN_HOME_PROVIDER structure set to WWAN_PROVIDER_STATE_HOME.
Set operations are only required to be supported by multi-carrier capable devices. The MB service will only set the home provider to multi-carrier providers reported by the miniport via OID_WWAN_PREFERRED_MULTICARRIER_PROVIDERS or OID_WWAN_VISIBLE_PROVIDERS. Set operations have an input buffer of NDIS_WWAN_SET_HOME_PROVIDER.
Remarks
A set operation should not require the user to unlock the device regardless if the current SIM or target SIM is in a locked state.
| Current Provider SIM | Target Provider SIM | Result of set HOME_PROVIDER |
|---|---|---|
| - | Locked | Target PIN not required for setting home provider |
| Locked | - | Source PIN not required for setting home provider |
| Locked | Locked | Source and Target PIN not required for setting home provider |
For more information about using this OID, see WWAN Provider Operations.
Miniport drivers can access the Subscriber Identity Module (SIM card) when processing query operations, but should not access the provider network.
Requirements
Version |
Available in Windows 7 and later versions of Windows. |
Header |
Ntddndis.h (include Ndis.h) |