Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
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.
Imposta la modalità di registrazione per il dispositivo.
Sintassi
HRESULT SetRegisterMode(
[in] MBN_REGISTER_MODE registerMode,
[in] LPCWSTR providerID,
[in] ULONG dataClass,
[out] ULONG *requestID
);
Parametri
[in] registerMode
Valore MBN_REGISTER_MODE che specifica la nuova modalità di registrazione.
[in] providerID
Stringa che specifica l'ID provider del provider di rete a cui eseguire la registrazione. Deve essere NULL quando registerMode è MBN_REGISTER_MODE_AUTOMATIC.
[in] dataClass
Combinazione bit per bit di valori OR MBN_DATA_CLASS che specificano le tecnologie di accesso ai dati preferite per la connessione. Il servizio Mobile Broadband registrerà la tecnologia della classe dati più elevata disponibile da questo elenco. Se non è possibile registrare alcuna classe di dati da questo elenco, il servizio Mobile Broadband verrà registrato nella classe di dati migliore disponibile.
[out] requestID
ID richiesta impostato dal servizio Mobile Broadband per identificare questa richiesta asincrona.
Valore restituito
Questo metodo può restituire uno di questi valori.
| Codice restituito | Descrizione |
|---|---|
|
Metodo completato correttamente. |
|
Il servizio Mobile Broadband non è in esecuzione in questo sistema. |
|
L'interfaccia non è valida, molto probabilmente perché il dispositivo Mobile Broadband è stato rimosso dal sistema. |
|
L'interfaccia non è valida. Molto probabilmente il dispositivo Mobile Broadband è stato rimosso dal sistema. |
|
Esiste già una connessione di rete attiva. La modalità di registrazione non può essere modificata mentre esiste una connessione dati già stabilita. L'applicazione chiamante deve prima disconnettere la connessione e quindi provare a modificare la modalità di registrazione. Se il dispositivo è già in modalità richiesta e connesso al provider richiesto, il codice restituito verrà S_OK. |
Commenti
Il metodo SetRegisterMode può essere usato per impostare un dispositivo in modalità di selezione automatica o manuale della rete. Per la modalità di registrazione manuale, l'ID di rete a cui deve essere registrato il dispositivo viene fornito in providerID.
Il supporto per la modalità di registrazione manuale è facoltativo e l'applicazione deve verificare che il dispositivo supporti la registrazione manuale controllando MBN_CTRL_CAPS_REG_MANUAL nel parametro interfaceCaps compilato dal metodo GetInterfaceCapability di IMbnInterface. Se un'applicazione imposta la modalità di registrazione manuale e non è supportata dal dispositivo, questa chiamata restituirà HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED).
SetRegisterMode è asincrono e restituirà immediatamente. Se non è presente alcun errore, al termine dell'operazione, il servizio Mobile Broadband chiamerà il metodo OnSetRegisterModeComplete di IMbnRegistrationEvents.
Requisiti
| Client minimo supportato | Windows 7 [app desktop | App UWP] |
| Server minimo supportato | Nessuno supportato |
| Piattaforma di destinazione | Windows |
| Intestazione | mbnapi.h |