Metodo IMbnMultiCarrier::SetHomeProvider (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.

Aggiornamenti il provider di casa per un dispositivo multi-gestore telefonico.

Sintassi

HRESULT SetHomeProvider(
  [in]  MBN_PROVIDER2 *homeProvider,
  [out] ULONG         *requestID
);

Parametri

[in] homeProvider

Struttura MBN_PROVIDER2 che contiene il provider home.

Nota

I membri SignalStrength e SignalError devono essere 0.

[out] requestID

Puntatore all'ID richiesta impostato dal sistema operativo per questa richiesta. La risposta asincrona di OnSetHomeProviderComplete conterrà lo stesso requestID.

Puntatore all'ID richiesta impostato dal sistema operativo per questa richiesta. La risposta asincrona conterrà lo stesso ID richiesta.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Metodo completato correttamente.
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)	Il servizio Mobile Broadband non è in esecuzione in questo sistema.
E_HANDLE	Interfaccia non valida. Il dispositivo Mobile Broadband è stato probabilmente rimosso dal sistema.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	Interfaccia non valida. Molto probabilmente il dispositivo Mobile Broadband è stato rimosso dal sistema.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	L'operazione non è supportata dal dispositivo. Questa operazione può essere restituita dai dispositivi che non supportano più vettori.

Commenti

Il metodo SetHomeProvider avvia un aggiornamento del provider home per l'interfaccia . Si tratta di un'operazione asincrona e la chiamata al metodo restituisce immediatamente. Se questo metodo viene restituito correttamente con S_OK, Windows notifica all'applicazione chiamante lo stato di completamento di questa operazione chiamando il metodo OnSetHomeProviderComplete di IMbnMultiCarrierEvents.

Il dispositivo verrà quindi registrato automaticamente nella nuova rete e indicherà una modifica dello stato di registrazione. Il dispositivo continuerà a essere registrato in questa nuova rete domestica tra i riavvii di Windows, a meno che SetHomeProvider non venga nuovamente usato per impostare un nuovo provider home.

Se il dispositivo viene rimosso dal sistema prima del completamento di questa operazione, non è garantito che la notifica di completamento venga ricevuta dall'applicazione chiamante.

Requisiti


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

Vedi anche

IMbnMultiCarrier

Condividi tramite