Metodo IMbnConnectionProfileManager::GetConnectionProfile (mbnapi.h)

Articolo
02/28/2024

Importante

A partire da Windows 10 versione 1803, le API Win32 descritte in questa sezione vengono sostituite dalle API Windows Runtime nello spazio dei nomi Windows.Networking.Connectivity.

Ottiene un profilo di connessione specifico associato al dispositivo Mobile Broadband specificato.

Sintassi

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

Parametri

[in] mbnInterface

Oggetto IMbnInterface che rappresenta il dispositivo per cui viene applicata la richiesta di profilo. Se mbnInterface è NULL, questa funzione restituirà il profilo del nome specificato associato a qualsiasi dispositivo nel sistema.

[in] profileName

Stringa con terminazione Null contenente il nome del profilo di connessione.

[out, retval] connectionProfile

Interfaccia IMbnConnectionProfile che rappresenta il profilo di connessione desiderato. Se questo metodo restituisce un valore diverso da S_OK, questo valore è NULL.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Metodo completato correttamente.
E_HANDLE	L'interfaccia non è valida, molto probabilmente perché il dispositivo Mobile Broadband è stato rimosso dal sistema.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	Un profilo con il nome specificato non esiste.
HRESULT_FROM_WIN32(ERROR_NOT_READY)	Il dispositivo non è pronto. Impossibile ottenere l'ID sottoscrittore perché il dispositivo non è MBN_READY_STATE_INITIALIZED.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	Un profilo con il nome specificato non esiste.

Commenti

Un profilo di connessione è associato all'ID sottoscrittore del dispositivo. Per i dispositivi GSM, l'ID sottoscrittore è l'Identità del Sottoscrittore mobile internazionale (IMSI) della SIM. Per i dispositivi CDMA si tratta della stringa MIN (Mobile Identification Number) o della stringa International Roaming MIN (IRM).

Se è stato creato un nuovo profilo usando CreateConnectionProfile, il chiamante deve attendere che l'evento OnConnectionProfileArrival venga ricevuto prima di chiamare GetConnectionProfile con il nome del nuovo profilo; in caso contrario, la chiamata API GetConnectionProfile potrebbe non riuscire con HRESULT_FROM_WIN32(ERROR_NOT_FOUND).

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	mbnapi.h

Vedi anche

IMbnConnectionProfileManager

Condividi tramite