Export (0) Print
Expand All

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 SIMTarget Provider SIMResult of set HOME_PROVIDER
-LockedTarget PIN not required for setting home provider
Locked-Source PIN not required for setting home provider
LockedLockedSource 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)

See also

NDIS_WWAN_HOME_PROVIDER
NDIS_STATUS_WWAN_HOME_PROVIDER
WWAN Provider Operations

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft