IMbnConnectionProfileManager::GetConnectionProfile-Methode (mbnapi.h)

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.

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

Weitere Informationen

IMbnConnectionProfileManager