Metodo IMbnConnection::Connect (mbnapi.h)

Articolo
08/24/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.

Stabilisce una connessione dati.

Sintassi

HRESULT Connect(
  [in]  MBN_CONNECTION_MODE connectionMode,
  [in]  LPCWSTR             strProfile,
  [out] ULONG               *requestID
);

Parametri

[in] connectionMode

Valore MBN_CONNECTION_MODE che specifica la modalità della connessione.

[in] strProfile

Contiene il designatore del profilo.

[out] requestID

Puntatore a un ID richiesta univoco restituito dal servizio Mobile Broadband per identificare questa richiesta asincrona.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	L'operazione è stata completata.
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)	Il servizio Mobile Broadband non è in esecuzione in questo sistema.
E_HANDLE	Interfaccia non valida. Probabilmente il dispositivo Mobile Broadband è stato rimosso dal sistema.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	Interfaccia non valida. Probabilmente il dispositivo Mobile Broadband è stato rimosso dal sistema.
E_INVALIDARG	È stato specificato un nome di profilo non valido o l'argomento strProfile non è conforme allo schema del profilo XML
E_MBN_MAX_ACTIVATED_CONTEXTS	Esiste già un contesto mobile a banda larga attiva. Non sono supportati più contesti attivi.

Commenti

Il metodo Connect viene usato per attivare un contesto di connessione per il dispositivo. Il servizio Mobile Broadband supporta attualmente al massimo un contesto attivo. L'attivazione del contesto comporterà anche la creazione della connessione L2. Analogamente, la disattivazione di un contesto comporterà la disconnessione della connessione dati fisica alla rete mobile.

Se il dispositivo non si trova nello stato collegato ai pacchetti al momento della chiamata a questa operazione, il servizio Mobile Broadband collega in modo implicito il dispositivo prima di inviare la richiesta di connessione al dispositivo. Se si verifica una modifica dello stato del servizio pacchetti, l'applicazione riceverà una notifica tramite una chiamata al metodo OnPacketServiceStateChange dell'interfaccia IMbnRegistrationEvents .

Se connectionMode è impostato su MBN_CONNECTION_MODE_PROFILE, strProfile rappresenta il nome del profilo per il dispositivo. Se impostato su MBN_CONNECTION_MODE_TMP_PROFILE, strProfile rappresenta la rappresentazione XML del profilo. Un'applicazione chiamante può usare IMbnConnectionProfileManager per ottenere un elenco di profili di connessione archiviati nel dispositivo.

Si tratta di un'operazione asincrona che restituirà immediatamente. Se questo metodo restituisce correttamente, il servizio Mobile Broadband chiamerà il metodo OnConnectComplete di IMbnConnectionEvents al termine dell'operazione.

Windows 8 e versioni successive di Windows: un'app di Windows Store può usare Connect con solo il MBN_CONNECTION_MODE_TMP_PROFILEconnectionMode e il parametro strProfile impostato su una rappresentazione XML del profilo. Ciò implica che la connessione è di natura temporanea e non salvata per l'uso futuro dal sistema.

Requisiti


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

Vedi anche

IMbnConnection

Condividi tramite