OID_WWAN_PIN_LIST

OID_WWAN_PIN_LIST returns a list of all the different types of Personal Identification Numbers (PINs) that are supported by the MB device and additional details for each PIN type, such as the length of the PIN (minimum and maximum lengths), PIN format, PIN-entry mode (enabled/disabled/not-available). This OID also specifies the current mode of each PIN supported by the device.

Set requests are not supported.

Miniport drivers must process query requests asynchronously, initially returning NDIS_STATUS_INDICATION_REQUIRED to the original request, and later sending an NDIS_STATUS_WWAN_PIN_LIST status notification containing an NDIS_WWAN_PIN_LIST structure to return a list of PINs with corresponding descriptions when completing query requests.

Remarks

For more information about using this OID, see WWAN Pin Operations.

Miniport drivers can access the Subscriber Identity Module (SIM card) when processing query operations, but should not access the provider network.

Miniport drivers must report all the PINs supported by their device. If the device does not support listing PINs, the miniport driver must report this list from a static (hard-coded) list maintained in the miniport driver itself for all the devices it supports.

Any PIN that provides device power-on verification or identification functionality should be reported as PIN1 and must be compliant to PIN1 guidelines.

Miniport drivers must return this information when the device ready-state changes to WwanReadyStateInitialized or when the device ready-state is WwanReadyStateDeviceLocked (PIN locked). Miniport drivers should also return this information in other device ready-states, wherever possible.

Requirements

Version

Available in Windows 7 and later versions of Windows.

Header

Ntddndis.h (include Ndis.h)

See also

NDIS_WWAN_PIN_LIST

NDIS_STATUS_WWAN_PIN_LIST

WWAN Pin Operations