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，因为 AttemptsRemaining 值对于此特定类型的 PIN 仍为非零。 微型端口驱动程序必须将 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 被阻止，微型端口驱动程序必须发送 ReadyState 设置为 WwanReadyStateBadSim的NDIS_STATUS_WWAN_READY_INFO。
响应 WwanPinOperationEnable、WwanPinOperationDisable 或 WwanPinOperationChange 请求
当微型端口驱动程序使用NDIS_STATUS_WWAN_PIN_INFO通知响应 WwanPinOperationEnable、WwanPinOperationDisable，以及 WwanPinOperationChange时，它们应实现以下作：
对于成功的请求，微型端口驱动程序必须将 uStatus 设置为WWAN_STATUS_SUCCESS。 有关WWAN_PIN_INFO中的其他成员，请参阅以下情况。
微型端口驱动程序必须将 uStatus 设置为在 PIN 处于请求状态时启用 PIN 和 PIN 禁用作的WWAN_STATUS_SUCCESS。 微型端口驱动程序必须将 PinType 设置为 WwanPinTypeNone。 将忽略其他成员。
当 PIN 模式从禁用更改为启用时，PIN 状态应为 WwanPinStateNone。
如果启用了 PIN1，则当电源循环到 MB 设备时，PIN 状态应变为 WwanPinStateEnter。
对于所有其他 PIN，PIN 状态可以根据 MB 设备特定条件从 WwanPinStateNone 更改为 WwanPinStateEnter。
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 |