Metodo IMbnConnectionProfileManager::GetConnectionProfiles (mbnapi.h)

Articolo
03/09/2023

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 elenco di profili di connessione associati al dispositivo.

Sintassi

HRESULT GetConnectionProfiles(
  [in]          IMbnInterface *mbnInterface,
  [out, retval] SAFEARRAY     **connectionProfiles
);

Parametri

[in] mbnInterface

Oggetto IMbnInterface che rappresenta il dispositivo per cui si applica la richiesta del profilo. Se si tratta di NULL, la funzione restituirà tutti i profili presenti nel sistema.

[out, retval] connectionProfiles

Matrice di interfacce IMbnConnectionProfile che rappresentano tutti i profili di connessione disponibili per il dispositivo. Se questo metodo restituisce qualsiasi elemento diverso da S_OK, il puntatore della matrice è NULL, altrimenti l'applicazione chiamante deve liberare la memoria allocata chiamando SafeArrayDestroy.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Metodo completato correttamente.
E_HANDLE	L'interfaccia non è valida, probabilmente perché il dispositivo Mobile Broadband è stato rimosso dal sistema.
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_SERVICE_NOT_ACTIVE)	Il servizio Mobile Broadband non è in esecuzione in questo sistema.

Commenti

Quando questa operazione viene chiamata per un determinato dispositivo, restituisce un elenco di profili con lo stesso ID sottoscrittore attualmente segnalato dal dispositivo. Il metodo GetSubscriberInformation di IMbnInterface può essere usato per ottenere l'ID sottoscrittore associato all'interfaccia.

Un profilo di connessione è associato all'ID sottoscrittore del dispositivo. Per i dispositivi GSM, l'ID sottoscrittore è l'identità del sottoscrittore internazionale (IMSI) della SIM. Per i dispositivi CDMA è la stringa Mobile Identification Number (MIN) o la stringa INTERNATIONAL Roaming MIN (IRM).

Requisiti


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