OID_WW_GEN_SIM_PUK

The OID_WW_GEN_SIM_PUK OID notifies an underlying miniport driver about the Personal Unblocking Key (PUK) that is programmed into the Security Identification Module (SIM). The miniport driver uses this PUK to reset the number of retry attempts that are available to protocols and applications to enter the correct PIN into the SIM so that the NIC's services can be accessed. For more information, see OID_WW_GEN_SIM_STATUS. This OID is defined as OPTIONAL.

This request uses a WW_ENABLE_SIM_PUK structure, defined as equivalent to the NDIS_VAR_DATA_DESCstructure, which was defined previously. The buffer that WW_ENABLE_SIM_PUK describes contains the PUK for the SIM as a network-ordered sequence of binary byte values.

For security reasons, the miniport driver should erase any internal copies of the PUK after using the PUK.

If a miniport driver's NIC does not use a SIM, the miniport driver should return an error value of NDIS_STATUS_NOT_SUPPORTED for incoming PUK notifications.

Queries and indications are irrelevant for this OID.

Note   This OID is not available for use beginning with Windows Vista.

 

 

 

Send comments about this topic to Microsoft