Freigeben über

NDIS_WWAN_PREFERRED_PROVIDERS-Struktur (ndiswwan.h)

  • Artikel

Die NDIS_WWAN_PREFERRED_PROVIDERS-Struktur stellt eine Liste der bevorzugten Anbieter dar, einschließlich der Anzahl der Anbieter in der Liste.

Syntax

typedef struct _NDIS_WWAN_PREFERRED_PROVIDERS {
  NDIS_OBJECT_HEADER Header;
  WWAN_STATUS        uStatus;
  WWAN_LIST_HEADER   PreferredListHeader;
} NDIS_WWAN_PREFERRED_PROVIDERS, *PNDIS_WWAN_PREFERRED_PROVIDERS;

Member

Header

Der Header mit Typ-, Revisions- und Größeninformationen zur NDIS_WWAN_PREFERRED_PROVIDERS-Struktur. Der MB-Dienst legt den Header mit den Werten fest, die in der folgenden Tabelle angezeigt werden, wenn er die Datenstruktur für Setvorgänge an den Miniporttreiber sendet. Miniporttreiber müssen den Header mit den gleichen Werten festlegen, wenn sie die Datenstruktur an den MB-Dienst senden.

Headerunterelement Wert
Typ NDIS_OBJECT_TYPE_DEFAULT
Revision NDIS_WWAN_PREFERRED_PROVIDERS_REVISION_1
Size sizeof(NDIS_WWAN_PREFERRED_PROVIDERS)
 

Weitere Informationen zu diesen Membern finden Sie unter NDIS_OBJECT_HEADER.

uStatus

Der Miniporttreiber muss dies auf WWAN_STATUS_SUCCESS für nicht angeforderte Ereignisse (NDIS_STATUS_INDICATION::RequestId = 0) festlegen. WWAN_STATUS_SUCCESS wird auch für die erfolgreiche Ausführung der NDIS_WWAN_SET_PREFERRED_PROVIDERS festgelegt.

Die folgende Tabelle enthält weitere mögliche Fehler status Codes (andere Member müssen nicht vom Miniporttreiber aktualisiert werden).

Wert Bedeutung
WWAN_STATUS_PIN_REQUIRED Für das Gerät ist eine PIN-Werteingabe erforderlich.
WWAN_STATUS_READ_FAILURE Fehler beim Lesen von Informationen vom Gerät oder sim-Karte oder beidem. Für die SIM-Karte sind beispielsweise keine Bevorzugten Anbieterinformationen bereitgestellt.
WWAN_STATUS_BAD_SIM Eine ungültige SIM-Karte wurde erkannt.
WWAN_STATUS_SIM_NOT_INSERTED SIM nicht in das Gerät eingefügt.
WWAN_STATUS_NO_DEVICE_SUPPORT Eine set-Anforderung wird nicht unterstützt.

PreferredListHeader

Ein formatiertes WWAN_LIST_HEADER -Objekt, das eine Liste der bevorzugten Anbieter darstellt, einschließlich der Anzahl der Anbieter in der Liste.

Diese verweisen auf die Liste der WWAN_PROVIDER2 mithilfe der WWAN_LIST_HEADER-Struktur. WwanDataClass-Flags beschreiben die Präferenz der spezifischen Datenzugriffstechnologie und können auf eine beliebige Kombination innerhalb der eigenen Mobilfunkklasse festgelegt werden.

Die Antwort auf das Festlegen OID_WWAN_PREFERRED_PROVIDERS Anforderungen müssen null Elemente im PreferenceListHeader enthalten.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Windows 7 und späteren Windows-Versionen.
Kopfzeile ndiswwan.h (include Ndiswwan.h)

Weitere Informationen

NDIS_OBJECT_HEADER

WWAN_LIST_HEADER