IMbnConnectionProfileManager::GetConnectionProfiles-Methode (mbnapi.h)

Artikel
08/24/2023

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
S_OK	Die Methode wurde erfolgreich abgeschlossen.
E_HANDLE	Die Schnittstelle ist ungültig, höchstwahrscheinlich, weil das mobile Breitbandgerät aus dem System entfernt wurde.
HRESULT_FROM_WIN32(ERROR_NOT_READY)	Das Gerät ist nicht bereit. Die Abonnenten-ID kann nicht abgerufen werden, da das Gerät nicht MBN_READY_STATE_INITIALIZED ist.
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)	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

Weitere Informationen

IMbnConnectionProfileManager

Freigeben über