Metodo IMbnConnectionEvents::OnConnectComplete (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.

Metodo di notifica che segnala il completamento di un'operazione di connessione.

Sintassi

HRESULT OnConnectComplete(
  [in] IMbnConnection *newConnection,
  [in] ULONG          requestID,
  [in] HRESULT        status
);

Parametri

[in] newConnection

Interfaccia IMbnConnection che rappresenta il dispositivo in cui è stata completata l'operazione di connessione.

[in] requestID

ID richiesta assegnato dal servizio Mobile Broadband per identificare l'operazione di connessione.

[in] status

Stato di completamento.

Un'applicazione chiamante può prevedere uno dei valori seguenti.

Valore	Significato
S_OK	L'operazione è stata completata.
E_MBN_SIM_NOT_INSERTED	Non è presente alcuna SIM nel dispositivo.
E_MBN_PIN_REQUIRED	Per completare l'operazione è necessario un PIN.
E_MBN_SERVICE_NOT_ACTIVATED	La sottoscrizione del servizio di rete è scaduta.
E_MBN_PROVIDER_NOT_VISIBLE	Il provider non è visibile. Questo vale solo per la modalità di registrazione manuale.
E_MBN_INVALID_ACCESS_STRING	La stringa di accesso alla connessione non è corretta.
HRESULT_FROM_WIN32(ERROR_INVALID_PASSWORD)	Il nome o la password che usa nel profilo di connessione non è corretto.
E_MBN_VOICE_CALL_IN_PROGRESS	È in corso una chiamata vocale attiva.
E_MBN_MAX_ACTIVATED_CONTEXTS	Esiste già un contesto Mobile Broadband attivo. Il servizio Mobile Broadband attualmente non supporta più contesti attivi.
E_MBN_RADIO_POWER_OFF	La radio del dispositivo è disattivata.
E_MBN_PACKET_SVC_DETACHED	Non è disponibile alcun servizio pacchetto collegato attivo.
E_MBN_ACTIVE_CONNECTION	Il dispositivo è già connesso alla rete.

Valore restituito

Questo metodo deve restituire S_OK.

Commenti

Dopo aver stabilito un contesto di attivazione, un'applicazione può usare IMbnConnection per ottenere lo stato di connessione corrente.

Quando l'operazione di connessione genera un errore, un'applicazione può chiamare il metodo GetActivationNetworkError dell'interfaccia IMbnConnection per ottenere informazioni sull'errore di rete.

Requisiti


Client minimo supportato	Windows 7 [app desktop \| App UWP]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	mbnapi.h

Vedi anche

IMbnConnectionEvents

Condividi tramite