OID_WWAN_PIN
OID_WWAN_PIN задает или возвращает сведения, связанные с личными идентификационнами (ПИН-кодами).
Драйверы минипорта должны обрабатывать запросы set и query в асинхронном режиме, первоначально возвращая NDIS_STATUS_INDICATION_REQUIRED в исходный запрос, а затем отправляя уведомление о состоянии NDIS_STATUS_WWAN_PIN_INFO после завершения запроса на набор или запрос.
Драйверы минипорта должны отправлять уведомления о состоянии NDIS_STATUS_WWAN_PIN_INFO, содержащие структуру NDIS_WWAN_PIN_INFO, чтобы возвращать сведения о типе ПИН-кода и вводе ПИН-кода, главным образом для указания того, требуется ли ПИН-код для разблокировки устройства в МБ или модуля идентификации подписчика (SIM-карта) при выполнении запросов.
Вызывающие абоненты, запрашивающие информацию, связанную с ПИН-кодами, предоставляют драйверу мини-порта NDIS_WWAN_SET_PIN структуру для отправки ПИН-кода на устройство в МБ, включения или отключения параметров ПИН-кода или изменения ПИН-кода на SIM-карте.
Комментарии
Дополнительные сведения об использовании этого объекта OID см. в разделе Операции закрепления WWAN .
Драйверы windows 7 miniport должны использовать OID_WWAN_PIN. Windows 8 драйверам минипорта следует использовать OID_WWAN_PIN_EX.
Драйверы минипорта могут получить доступ к модулю идентификации подписчика (SIM-карта) при обработке операций запроса, но не должны обращаться к сети поставщика.
Во время процесса инициализации драйвера мини-порта служба MB не переходит к регистрации, пока ПИН-код 1 не будет успешно разблокирован, если он включен.
Драйверы miniport предоставляют значение ПИН-кода, введенное конечным пользователем в элементе PinAction.Pin структуры NDIS_WWAN_SET_PIN при обработке запросов на набор. Драйвер мини-порта должен обрабатывать запрос, только если значение ПИН-кода совпадает со значением, хранящимся в SIM-карта. В противном случае драйверы мини-порта должны завершить запрос на набор с кодом состояния WWAN_STATUS_FAILURE.
Устройства на основе CDMA должны сообщать о блокировке питания устройства в виде ПИН-кода1.
Для всех поддерживаемых типов ПИН-кодов драйверы минипорта должны поддерживать операцию WwanPinOperationEnter . Кроме того, если поддерживается ПИН-код1, драйверы мини-порта должны поддерживать операции WwanPinOperationEnable, WwanPinOperationDisable и WwanPinOperationChange .
Если операция отключения ПИН-кода для типа ПИН-кода выполняется при блокировке этого типа ПИН-кода, драйверы мини-порта могут либо завершить запрос с WWAN_STATUS_PIN_REQUIRED, либо успешно завершить запрос. Если драйвер мини-порта успешно выполняет запрос, операция отключения также должна разблокировать ПИН-код.
Если в отчете включено несколько ПИН-кодов и одновременно можно сообщить только один ПИН-код, то предполагается, что водители мини-портов сначала сообщат о ПИН-коде1. Например, если включены отчеты о СубсидииLock и PIN-коде SIM-карты 1, то PIN-код Субсидий Заблокировки должен быть передан (в последующем запросе) только после успешной проверки ПИН-кода 1.
API MB поддерживает другие ПИН-коды в дополнение к ПИН-коду 1. Однако потребуется установить сторонний диспетчер подключений или графический интерфейс, так как windows диспетчер подключений и графический интерфейс поддерживает только ПИН-код1.
Требования
Версия |
Доступно в Windows 7 и более поздних версиях Windows. |
Заголовок |
Ntddndis.h (включая Ndis.h) |