IOCTL_GNSS_CONFIG_SUPL_CERT IOCTL (gnssdriver.h)

Artikel
02/29/2024

Der IOCTL_GNSS_CONFIG_SUPL_CERT-Steuerelementcode wird vom GNSS-Adapter verwendet, um SUPL-Zertifikate festzulegen.

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

Zeiger auf eine GNSS_SUPL_CERT_CONFIG-Struktur .

Eingabepufferlänge

Legen Sie auf sizeof(GNSS_SUPL_CERT_CONFIG) fest.

Ausgabepuffer

Auf NULL festgelegt.

Länge des Ausgabepuffers

Auf 0 festlegen.

Statusblock

Irp->IoStatus.Status ist auf STATUS_SUCCESS festgelegt, wenn die Anforderung erfolgreich ist. Andernfalls wird status für die entsprechende Fehlerbedingung als NTSTATUS-Code verwendet.

Hinweise

Der Treiber legt einen der folgenden NTSTATUS-Werte fest, um das Ergebnis anzugeben.

STATUS_SUCCESS, wenn der Treiber die SUPL-Zertifikatinformationen erfolgreich verarbeitet. Wenn die IOCTL versucht, nicht vorhandene Zertifikate zu löschen oder zu bereinigen, gibt sie trotzdem STATUS_SUCCESS zurück.
Fehler, wenn der Treiber die SUPL-Zertifikatinformationen nicht erfolgreich verarbeitet.
Wird ignoriert, wenn der Treiber die SUPL-Zertifikatinformationen ignoriert.

Hinweise zu GNSS-Adaptern

Für GNSS DDI Version 1:

Der GNSS-Adapter muss nichts Besonderes tun.

Für GNSS DDI Version 2 und höher:

Der GNSS-Adapter verweist nur auf Zertifikate nach Name. Es liegt beim GNSS-Treiber, die Zertifikatnamen bei Bedarf intern jeder anderen Darstellung oder einem Verweis auf die Zertifikate zuzuordnen.

Der GNSS-Adapter führt bei Bedarf eine vollständige Bereinigung oder alle zuvor eingefügten Zertifikate durch, bevor eine neue Gruppe eingefügt wird.

Hinweise zu GNSS-Treibern

Der GNSS-Treiber muss diese Zertifikatinformationen an die SUPL-Komponente übergeben, die das Zertifikat zum Einrichten einer sicheren Verbindung mit H-SLP verwenden sollte.

Für GNSS DDI Version 2 und höher:

Der GNSS-Treiber muss das Empfangen mehrerer Aufrufe des IOCTL_GNSS_CONFIG_SUPL_CERT unterstützen. Der GNSS-Adapter ruft diese IOCTL mehrmals auf, jedes Mal, um ein anderes Stammzertifikat einzuschleusen. Unterschiedliche Stammzertifikate werden durch einen anderen SuplCertName identifiziert, der den Namen des eingefügten Zertifikats angibt.

Wenn der Name mit einem zuvor konfigurierten Zertifikat übereinstimmt, wird das Zertifikat ersetzt.
Wenn sich der Name vom Zertifikat unterscheidet, wird das neue Zertifikat hinzugefügt.

Wenn ein Zertifikat mit demselben Namen wie ein vorhandenes Zertifikat erneut eingefügt wird, sollte der GNSS-Treiber das vorherige Zertifikat mit demselben Namen überschreiben.