NDIS_STATUS_WWAN_PIN_INFO
微型端口驱动程序使用NDIS_STATUS_WWAN_PIN_INFO通知响应 OID 查询和设置 OID_WWAN_PIN的请求。
微型端口驱动程序不能使用此通知发送未经请求的事件。
此通知使用 NDIS_WWAN_PIN_INFO 结构。
注解
微型端口驱动程序应返回有关 MB 设备当前预期用于响应查询请求的个人标识号 (PIN) 的信息。 微型端口驱动程序应返回填充的状态通知，如以下部分所述，以响应设置的请求。
响应 WwanPinOperationEnter 请求
当微型端口驱动程序使用NDIS_STATUS_WWAN_PIN_INFO通知响应 WwanPinOperationEnter 请求时，它们应实现以下过程：
对于成功的 WwanPinOperationEnter 查询请求，当 MB 设备不再需要 PIN 时，微型端口驱动程序必须将 uStatus 设置为 WWAN_STATUS_SUCCESS ，将 PinType 设置为 WwanPinTypeNone。
对于失败的 WwanPinOperationEnter 请求，微型端口驱动程序必须将 uStatus 设置为 WWAN_STATUS_FAILURE，并按照以下详细信息包括适用的数据：
PIN 禁用或 PIN 不预期：对于 WwanPinOperationEnter 设置请求，当 MB 设备禁用或当前不期望相应的 PIN 时，微型端口驱动程序必须将 PinType 设置为 WwanPinTypeNone。 将忽略所有其他成员。
不支持 PIN：如果 MB 设备不支持给定的 PIN，微型端口驱动程序必须将 uStatus 设置为 WWAN_STATUS_NO_DEVICE_SUPPORT。
PIN 重试：在此模式下，MB 设备需要重新输入 PIN，因为对于此特定类型的 PIN， AttemptsRemaining 值仍然是非零。 微型端口驱动程序必须将 PinType 设置为与 NDIS_WWAN_SET_PIN 中的 PinType 相同的值。
PIN 阻止： 在 AttemptsRemaining 为零时阻止 PIN。 如果 PIN 取消阻止操作不可用，微型端口驱动程序必须将 uStatus 设置为 WWAN_STATUS_FAILURE ，将 PinType 设置为 WwanPinTypeNone。 将忽略所有其他成员。
注意 如果 MB 设备支持 PIN 取消阻止操作，微型端口驱动程序应遵循 PIN 取消阻止步骤来响应请求。
PIN 取消阻止： 在 AttemptsRemaining 为零时阻止 PIN。 若要取消阻止 PIN，MB 设备可能会请求相应的 PIN 解锁密钥 (PUK) （如果适用）。 在这种情况下，微型端口驱动程序必须将 PinType 设置为相应的 WwanPinTypeXxxPUK 以及相关详细信息。
阻止的 PUK：如果失败的试用次数超过输入 WwanPinTypeXxxPUK 的预设值，则 PUK 将被阻止。 微型端口驱动程序必须通过将 uStatus 设置为 WWAN_STATUS_FAILURE 并将 PinType 设置为 WwanPinTypeNone 来发出信号。 如果 PUK1 被阻止，微型端口驱动程序必须发送一个NDIS_STATUS_WWAN_READY_INFO ，并将 ReadyState 设置为 WwanReadyStateBadSim。
响应 WwanPinOperationEnable、WwanPinOperationDisable 或 WwanPinOperationChange 请求
当微型端口驱动程序使用NDIS_STATUS_WWAN_PIN_INFO通知响应 WwanPinOperationEnable、 WwanPinOperationDisable 和 WwanPinOperationChange 时，它们应实现以下操作：
对于成功的请求，微型端口驱动程序必须将 uStatus 设置为 WWAN_STATUS_SUCCESS。 有关WWAN_PIN_INFO中的其他成员，请参阅以下情况。
当 PIN 已处于请求状态时，微型端口驱动程序必须将 uStatus 设置为 WWAN_STATUS_SUCCESS，以便执行 PIN 启用和 PIN 禁用操作。 微型端口驱动程序必须将 PinType 设置为 WwanPinTypeNone。 将忽略其他成员。
当 PIN 模式从禁用更改为启用时，PIN 状态应为 WwanPinStateNone。
如果启用 PIN1，则当电源循环到 MB 设备时，PIN 状态应变为 WwanPinStateEnter。
对于所有其他 PIN，PIN 状态可以从 WwanPinStateNone 更改为 WwanPinStateEnter，具体取决于 MB 设备的特定条件。
不支持 PIN：如果 MB 设备不支持 PIN 操作，微型端口驱动程序必须将 uStatus 设置为 WWAN_STATUS_NO_DEVICE_SUPPORT。 例如，MB 设备通常不支持启用或禁用 PIN2，因此必须返回上述错误代码。 将忽略所有其他成员。
必须输入 PIN：如果 PIN 操作需要输入 PIN，微型端口驱动程序必须将 uStatus 设置为 WWAN_STATUS_PIN_REQUIRED ，将 PinType 设置为 WwanPinTypeXxx。 将忽略其他成员。
PIN 更改操作：如果 MB 设备仅在处于启用状态时才限制 PIN 值的更改，则必须使用 WWAN_STATUS_PIN_DISABLED 返回更改禁用状态的请求。
PIN 重试：失败时，微型端口驱动程序必须将 uStatus 设置为 WWAN_STATUS_FAILURE， 将 PinType 设置为与 NDIS_WWAN_SET_PIN 中指定的值相同。 除 AttemptsRemaining 外，将忽略其他成员。 输入错误的 PIN 时，可能会发生这种情况。
PIN 阻止：当 AttemptsRemaining 数为零时，将阻止 PIN。 如果 PIN 取消阻止操作不可用，微型端口驱动程序必须将 uStatus 设置为 WWAN_STATUS_FAILURE ，将 PinType 设置为 WwanPinTypeNone。 AttemptsRemaining 应设置为 0，并忽略所有其他成员。
注意 如果 MB 设备支持 PIN 取消阻止操作，微型端口驱动程序应遵循 PIN 取消阻止步骤来响应请求。
取消阻止 PIN： 在 AttemptsRemaining 为零时阻止 PIN。 若要取消阻止 PIN，MB 设备可能会请求相应的 PUK（如果适用）。 在这种情况下，微型端口驱动程序必须将 uStatus 设置为 WWAN_STATUS_FAILURE， 将 PinType 设置为相应的 WwanPinTypeXxxPUK， 将 PinState 设置为 WwanPinStateEnter，并且 AttemptsRemaining 应具有允许输入有效 PUK 的尝试次数。
如果 PIN 阻止导致 MB 设备或 SIM 卡被阻止，微型端口驱动程序必须发送 事件通知，并将 ReadyState 设置为 WwanReadyStateDeviceLocked。
如果在 PIN1 阻止时存在活动的 PDP 上下文，微型端口驱动程序必须停用 PDP 上下文，并将有关 PDP 停用和链接状态更改的通知发送到操作系统。
要求
版本 |
在 Windows 7 和更高版本的 Windows 中可用。 |
标头 |
Ndis.h |