IMbnConnectionProfileManager::GetConnectionProfile-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 ein bestimmtes Verbindungsprofil ab, das dem angegebenen Mobilen Breitbandgerät zugeordnet ist.

Syntax

HRESULT GetConnectionProfile(
  [in]          IMbnInterface         *mbnInterface,
  [in]          LPCWSTR               profileName,
  [out, retval] IMbnConnectionProfile **connectionProfile
);

Parameter

[in] mbnInterface

Ein IMbnInterface , das das Gerät darstellt, für das die Profilanforderung gilt. Wenn mbnInterfaceNULL ist, gibt diese Funktion das Profil des angegebenen Namens zurück, das jedem Gerät im System zugeordnet ist.

[in] profileName

Eine Zeichenfolge mit NULL-Beendigung, die den Namen des Verbindungsprofils enthält.

[out, retval] connectionProfile

Eine IMbnConnectionProfile-Schnittstelle , die das gewünschte Verbindungsprofil darstellt. Wenn diese Methode etwas anderes als S_OK zurückgibt, ist dies NULL.

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_FOUND)	Ein Profil mit dem angegebenen Namen ist nicht vorhanden.
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_NOT_FOUND)	Ein Profil mit dem angegebenen Namen ist nicht vorhanden.

Hinweise

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).

Wenn mithilfe von CreateConnectionProfile ein neues Profil erstellt wurde, muss der Aufrufer warten, bis das OnConnectionProfileArrival-Ereignis empfangen wird, bevor GetConnectionProfile mit dem Namen des neuen Profils aufgerufen wird. Andernfalls schlägt der Aufruf der GetConnectionProfile-API möglicherweise mit HRESULT_FROM_WIN32(ERROR_NOT_FOUND) fehl.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	mbnapi.h

Weitere Informationen

IMbnConnectionProfileManager