OID_WWAN_PIN

项目
06/15/2023

OID_WWAN_PIN设置或返回与个人标识号 (PIN) 相关的信息。

微型端口驱动程序必须异步处理集和查询请求，最初将NDIS_STATUS_INDICATION_REQUIRED返回到原始请求，然后在完成设置或查询请求后发送 NDIS_STATUS_WWAN_PIN_INFO 状态通知。

微型端口驱动程序应发送包含 NDIS_WWAN_PIN_INFO结构的NDIS_STATUS_WWAN_PIN_INFO状态通知，以返回 PIN 类型和 PIN 输入状态信息，主要是为了指示在完成查询请求时是否需要 PIN 来解锁 MB 设备或订阅者标识模块 (SIM 卡卡) 。

请求设置与 PIN 相关的信息的调用方向微型端口驱动程序提供 NDIS_WWAN_SET_PIN 结构，以便向 MB 设备发送 PIN、启用或禁用 PIN 设置，或更改 SIM 卡上的 PIN。

注解

有关使用此 OID 的详细信息，请参阅 WWAN Pin 操作。

Windows 7 微型端口驱动程序应使用 OID_WWAN_PIN。 Windows 8微型端口驱动程序应使用 OID_WWAN_PIN_EX。

处理查询操作时，微型端口驱动程序可以访问订阅者标识模块 (SIM 卡) ，但不应访问提供程序网络。

在微型端口驱动程序初始化过程中，如果启用，则在成功解锁 PIN1 之前，MB 服务不会继续注册。

处理集请求时，微型端口驱动程序在 NDIS_WWAN_SET_PIN 结构的 PinAction.Pin 成员中提供由最终用户输入的 PIN 值。仅当 PIN 值与 SIM 卡中存储的值匹配时，微型端口驱动程序才能处理请求。否则，微型端口驱动程序应使设置请求失败，状态代码WWAN_STATUS_FAILURE。

基于 CDMA 的设备必须将开机设备锁报告为 PIN1。

对于所有受支持的 PIN 类型，微型端口驱动程序必须支持 WwanPinOperationEnter 操作。此外，如果支持 PIN1，微型端口驱动程序必须支持 WwanPinOperationEnable、 WwanPinOperationDisable 和 WwanPinOperationChange 操作。

如果在锁定 PIN 类型时尝试对 PIN 类型执行 PIN 禁用操作，微型端口驱动程序可能会使请求失败并WWAN_STATUS_PIN_REQUIRED，或者可以成功完成请求。如果微型端口驱动程序成功完成请求，则禁用操作还应解锁 PIN。

如果启用了报告多个 PIN，并且一次只能报告一个 PIN，则微型端口驱动程序应首先报告 PIN1。例如，如果启用了报告 SubsidyLock 和 SIM PIN1，则只有在成功验证 PIN1 后，才应在后续查询请求中 (报告) SubsidyLock PIN。

除了 PIN1 之外，MB API 还支持其他 PIN。但是，需要安装第三方连接管理器/GUI，因为 Windows 连接管理器/GUI 仅支持 PIN1。