IMbnConnection::GetConnectionState-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 den aktuellen Verbindungsstatus des Geräts ab.

Syntax

HRESULT GetConnectionState(
  [out, retval] MBN_ACTIVATION_STATE *ConnectionState,
  [out, retval] BSTR                 *ProfileName
);

Parameter

[out, retval] ConnectionState

Ein Zeiger auf eine MBN_ACTIVATION_STATE-Struktur , die den Zustand der Verbindung enthält.

[out, retval] ProfileName

Ein Zeiger auf eine Zeichenfolge, die den Namen des Verbindungsprofils enthält. Dieser Parameter ist nur gültig, wenn ConnectionStateMBN_ACTIVATION_STATE_ACTIVATED ist. Wenn diese Zeichenfolge nicht NULL ist, muss die aufrufende Anwendung diese Zeichenfolge durch Aufrufen von SysFreeString freigeben.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich abgeschlossen. Hinweis Diese Methode kann S_OK zurückgeben, wenn ProfileNameNULL ist. Stellen Sie sicher, dass Ihr Client einen NULL-Profilnamen auch dann verarbeiten kann, wenn der Aufruf erfolgreich ist.
E_PENDING	Der Aktivierungsstatus ist nicht verfügbar. Der Mobile Broadband-Dienst überprüft das Gerät nach den Informationen. Die aufrufende Anwendung kann benachrichtigt werden, wenn der Aktivierungsstatus verfügbar ist, indem sie sich für die OnConnectStateChange-Methode von IMbnConnectionEvents registriert.
E_MBN_PIN_REQUIRED	Zum Abrufen des Anrufstatus ist eine PIN erforderlich.
E_MBN_SIM_NOT_INSERTED	Eine SIM-Karte ist nicht in das Gerät eingefügt.
E_MBN_BAD_SIM	Eine ungültige SIM-Karte wird in das Gerät eingefügt.

Hinweise

Diese Methode kann S_OK zurückgeben, wenn ProfileNameNULL ist. Stellen Sie sicher, dass Ihr Client einen NULL-Profilnamen auch dann verarbeiten kann, wenn der Aufruf erfolgreich ist.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 7 [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	mbnapi.h

Weitere Informationen

IMbnConnection

Freigeben über