IMbnConnectionProfileManager::GetConnectionProfiles-Methode (mbnapi.h)
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 |