IOCTL_GNSS_CONFIG_SUPL_CERT IOCTL (gnssdriver.h)

2025-02-07

Код элемента управления IOCTL_GNSS_CONFIG_SUPL_CERT используется адаптером GNSS для задания сертификатов SUPL.

Основной код

IRP_MJ_DEVICE_CONTROL

Входной буфер

Указатель на структуру GNSS_SUPL_CERT_CONFIG.

Длина входного буфера

Задайте для sizeof(GNSS_SUPL_CERT_CONFIG).

Выходной буфер

Установите значение NULL.

Длина выходного буфера

Установите значение 0.

Блок состояния

Irp->IoStatus.Status STATUS_SUCCESS, если запрос выполнен успешно. В противном случае состояние соответствующего условия ошибки в качестве кода NTSTATUS.

Замечания

Драйвер задает одно из следующих значений NTSTATUS, чтобы указать результат.

STATUS_SUCCESS, когда драйвер успешно обрабатывает сведения о сертификате SUPL. Если IOCTL пытается удалить или очистить сертификаты, которые не существуют, он по-прежнему возвращает STATUS_SUCCESS.
Сбой, если драйвер не обрабатывает сведения о сертификате SUPL успешно.
Игнорируется, если драйвер игнорирует сведения о сертификате SUPL.

заметки о адаптере GNSS

Для GNSS DDI версии 1:

Адаптер GNSS не должен делать ничего особенного.

Для GNSS DDI версии 2 и более поздних версий:

Адаптер GNSS будет ссылаться только на сертификаты по имени. При необходимости драйвер GNSS будет сопоставлять имена сертификатов внутренне с любым другим представлением или ссылкой на сертификаты.

Адаптер GNSS выполнит полную очистку или все ранее введенные сертификаты при необходимости перед внедрением нового набора.

заметки о драйвере GNSS

Драйвер GNSS должен передать эти сведения о сертификате компоненту SUPL, который должен использовать сертификат для настройки безопасного подключения к H-SLP.

Для GNSS DDI версии 2 и более поздних версий:

Драйвер GNSS должен поддерживать получение нескольких вызовов IOCTL_GNSS_CONFIG_SUPL_CERT. Адаптер GNSS вызывает этот IOCTL несколько раз, каждый раз для внедрения другого корневого сертификата. Различные корневые сертификаты определяются с помощью другого SuplCertName, который предоставляет имя внедряемого сертификата.

Если имя совпадает с ранее настроенным сертификатом, то сертификат будет заменен.
Если имя отличается от сертификата, будет добавлен новый сертификат.

Если сертификат с тем же именем, что и существующий сертификат, снова внедряется, драйвер GNSS должен перезаписать предыдущий сертификат с тем же именем.