OID_WW_GEN_SIM_EXCEPTION

The OID_WW_GEN_SIM_EXCEPTION OID requests an underlying miniport driver to return information that specifies status for various SIM-related conditions. The following lists the valid status values from the WW_GEN_SIM_EXCEPTION enumeration. This OID is defined as OPTIONAL.

  • SIM_STATUS_OK
    No known error conditions related to the SIM.

  • SIM_STATUS_ERROR
    General SIM-related failure. A status error of this type indicates that possibly the NIC's SIM should be returned for service.

  • SIM_STATUS_MISSING
    The SIM is not inserted in the NIC but is required to access the NIC's services.

  • SIM_STATUS_NO_RESPONSE
    The SIM is inserted in the NIC but not responding to requests. A status error of this type indicates that possibly the NIC's SIM should be returned for service.

  • SIM_STATUS_REMOVED
    The SIM has been detached from the NIC.

  • SIM_STATUS_CRYPT_ERROR
    The contents of the SIM is corrupt. A status error of this type indicates that possibly the SIM is defective or has been tampered with. The SIM should be returned for service.

  • SIM_STATUS_AUTH_ERROR
    Authentication for the SIM has failed. A status error of this type indicates that possibly the SIM is defective or has been tampered with. The SIM should be returned for service.

  • SIM_STATUS_NEED_PIN
    The SIM requires a PIN before access to the NIC's services is granted.

  • SIM_STATUS_NEED_PUK
    The SIM requires a PUK to reset the number of retry attempts that are available to protocols and applications to enter the correct PIN into the SIM. A status error of this type indicates that entry of a PIN into the SIM has exceeded the available number of attempts. For more information, see OID_WW_GEN_SIM_STATUS and OID_WW_GEN_SIM_PUK.

  • SIM_STATUS_WRONG
    A SIM is inserted in the NIC but is the incorrect SIM for the NIC. That is, this particular type of SIM is not compatible with the NIC.

Queries with this OID return the most recently recorded SIM-related condition. If any bound protocol has enabled indications with OID_WW_GEN_INDICATION_REQUEST, the miniport driver must call NdisMIndicateStatusto notify such protocol(s) if any SIM operation generates one of the status conditions in the WW_GEN_SIM_EXCEPTION enumeration. It can ignore the TriggerValue member that was specified in the OID_WW_GEN_INDICATION_REQUEST.

Sets are irrelevant for this OID.

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

 

 

 

Send comments about this topic to Microsoft