IOCTL_GNSS_CONFIG_SUPL_CERT IOCTL (gnssdriver.h)

Artigo
08/07/2023

O código de controle IOCTL_GNSS_CONFIG_SUPL_CERT é usado pelo adaptador GNSS para definir certificados SUPL.

Código principal

IRP_MJ_DEVICE_CONTROL

Buffer de entrada

Ponteiro para uma estrutura GNSS_SUPL_CERT_CONFIG .

Comprimento do buffer de entrada

Defina como sizeof(GNSS_SUPL_CERT_CONFIG).

Buffer de saída

Defina como NULL.

Comprimento do buffer de saída

Defina como 0.

Bloco de status

Irp->IoStatus.Status será definido como STATUS_SUCCESS se a solicitação for bem-sucedida. Caso contrário, Status para a condição de erro apropriada como um código NTSTATUS .

Comentários

O driver define um dos seguintes valores NTSTATUS para indicar o resultado.

STATUS_SUCCESS, quando o driver processa as informações do certificado SUPL com êxito. Se o IOCTL tentar excluir ou limpar certificados que não existem, ele ainda retornará STATUS_SUCCESS.
Com falha, quando o driver não processa as informações do certificado SUPL com êxito.
Ignorado, quando o driver ignora as informações do certificado SUPL.

Notas do adaptador GNSS

Para o GNSS DDI versão 1:

O adaptador GNSS não precisa fazer nada especial.

Para o GNSS DDI versão 2 e posterior:

O adaptador GNSS se referirá apenas a certificados por nome. Cabe ao driver GNSS mapear os nomes de certificado internamente para qualquer outra representação ou referência aos certificados, se necessário.

O adaptador GNSS fará uma limpeza completa ou todos os certificados injetados anteriormente, se necessário, antes de injetar um novo conjunto.

Notas do driver GNSS

O driver GNSS precisa passar essas informações de certificado para o componente SUPL, que deve usar o certificado para configurar a conexão segura com o H-SLP.

Para o GNSS DDI versão 2 e posterior:

O driver GNSS deve dar suporte ao recebimento de várias chamadas do IOCTL_GNSS_CONFIG_SUPL_CERT. O adaptador GNSS chamará esse IOCTL várias vezes, cada vez para injetar um certificado raiz diferente. Certificados raiz diferentes são identificados por terem um SuplCertName diferente, que fornece o nome do certificado que está sendo injetado.

Se o nome for o mesmo que um certificado configurado anteriormente, o certificado será substituído.
Se o nome for diferente do certificado, o novo certificado será adicionado.

Se um certificado com o mesmo nome de um certificado existente for injetado novamente, o driver GNSS deverá substituir o certificado anterior pelo mesmo nome.