Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Wichtig
Ab Windows 10 Version 1803 werden die in diesem Abschnitt beschriebenen Win32-APIs durch die Windows-Runtime-APIs im Windows.Networking.Connectivity-Namespace ersetzt.
Ruft eine Liste von Verbindungsprofilen ab, die dem Gerät zugeordnet sind.
Syntax
HRESULT GetConnectionProfiles(
[in] IMbnInterface *mbnInterface,
[out, retval] SAFEARRAY **connectionProfiles
);
Parameter
[in] mbnInterface
Ein IMbnInterface , das das Gerät darstellt, für das die Profilanforderung gilt. Wenn dies NULL ist, gibt die Funktion alle Profile zurück, die im System vorhanden sind.
[out, retval] connectionProfiles
Ein Array von IMbnConnectionProfile-Schnittstellen , die alle verfügbaren Verbindungsprofile für das Gerät darstellen. Wenn diese Methode etwas anderes als S_OK zurückgibt, ist der Arrayzeiger NULL. Andernfalls muss die aufrufende Anwendung den zugeordneten Arbeitsspeicher schließlich durch Aufrufen von SafeArrayDestroy freigeben.
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Die Methode wurde erfolgreich abgeschlossen. |
|
Die Schnittstelle ist ungültig, höchstwahrscheinlich, weil das mobile Breitbandgerät aus dem System entfernt wurde. |
|
Das Gerät ist nicht bereit. Die Abonnenten-ID kann nicht abgerufen werden, da das Gerät nicht MBN_READY_STATE_INITIALIZED ist. |
|
Der mobile Breitbanddienst wird auf diesem System nicht ausgeführt. |
Hinweise
Wenn dieser Vorgang für ein bestimmtes Gerät aufgerufen wird, wird eine Liste von Profilen zurückgegeben, die dieselbe Abonnenten-ID aufweisen, wie sie derzeit vom Gerät gemeldet wird. Die GetSubscriberInformation-Methode von IMbnInterface kann verwendet werden, um die der Schnittstelle zugeordnete Abonnenten-ID abzurufen.
Ein Verbindungsprofil ist der Abonnenten-ID des Geräts zugeordnet. Bei GSM-Geräten ist die Abonnenten-ID die International Mobile Subscriber Identity (IMSI) der SIM. Bei CDMA-Geräten handelt es sich um die Zeichenfolge für die mobile Identifikationsnummer (Mobile Identification Number, MIN) oder die Zeichenfolge international roaming MIN (IRM).
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 7 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Zielplattform | Windows |
| Kopfzeile | mbnapi.h |