Metodo IDot11AdHocNetwork::Connect (adhoc.h)
Si connette a una rete ad hoc wireless creata in precedenza. Prima che un'applicazione possa connettersi a una rete, è necessario che la rete sia stata creata usando IDot11AdHocManager::CreateNetwork ed eseguito il commit con IDot11AdHocManager::CommitCreatedNetwork.
Sintassi
HRESULT Connect(
[in] LPCWSTR Passphrase,
[in] LONG GeographicalId,
[in] BOOLEAN fSaveProfile,
[in] BOOLEAN fMakeSavedProfileUserSpecific
);
Parametri
[in] Passphrase
Stringa della password usata per autenticare l'utente o il computer nella rete.
La lunghezza della stringa password dipende dalle impostazioni di sicurezza passate nel parametro pSecurity della chiamata CreateNetwork . La tabella seguente illustra la lunghezza della password associata a varie impostazioni di sicurezza.
| Impostazioni di sicurezza | Lunghezza password |
|---|---|
| Open-None | 0 |
| Open-WEP | 5 o 13 caratteri; 10 o 26 cifre esadecimali |
| WPA2PSK | Da 8 a 63 caratteri |
Per i valori enumerati che corrispondono alla coppia di impostazioni di sicurezza precedente, vedere DOT11_ADHOC_AUTH_ALGORITHM e DOT11_ADHOC_CIPHER_ALGORITHM.
[in] GeographicalId
Posizione geografica in cui è stata creata la rete. Per un elenco dei valori possibili, vedere Tabella delle posizioni geografiche.
[in] fSaveProfile
Parametro facoltativo che specifica se deve essere salvato un profilo wireless. Se TRUE, il profilo viene salvato nell'archivio profili. Dopo aver salvato un profilo, l'utente può modificare il profilo usando l'interfaccia utente Gestisci rete wireless . I profili possono anche essere modificati usando le funzioni Native Wifi.
Il salvataggio di un profilo modifica la firma di rete restituita da IDot11AdHocNetwork::GetSignature.
[in] fMakeSavedProfileUserSpecific
Parametro facoltativo che specifica se il profilo da salvare è un profilo all-utente. Se è impostata su TRUE, il profilo è specifico dell'utente corrente. Se è impostata su FALSE, il profilo è un profilo utente completo e può essere usato da qualsiasi utente connesso al computer. Questo parametro viene ignorato se fSaveProfile è FALSE.
Per impostazione predefinita, solo i membri del gruppo Administrators possono salvare un profilo all-user. Queste impostazioni di sicurezza possono essere modificate usando la funzione WlanSetSecuritySettings . L'applicazione deve essere avviata da un utente con privilegi sufficienti per il salvataggio corretto di un profilo all-utente.
Se l'applicazione è in esecuzione in una finestra desktop remoto, è possibile salvare solo un profilo utente. I profili specifici dell'utente non possono essere salvati da un'applicazione in esecuzione in remoto.
Valore restituito
I valori restituiti possibili includono, ma non sono limitati ai valori seguenti.
| Codice restituito | Descrizione |
|---|---|
|
Metodo completato correttamente. |
|
Il metodo non è riuscito. |
|
Uno dei parametri non è valido. |
|
Un'interfaccia specificata non è supportata. |
|
Impossibile allocare la memoria necessaria per eseguire questa operazione. |
|
Un puntatore passato come parametro non è valido. |
Commenti
Questo metodo è asincrono. Connect restituisce S_OK immediatamente se i parametri passati al metodo sono validi. Tuttavia, un codice restituito di S_OK non indica che la connessione è riuscita. È necessario registrarsi per le notifiche nell'interfaccia IDot11AdHocNetworkNotificationSink per ricevere una notifica dell'esito positivo o negativo della connessione. Il metodo IDot11AdHocNetworkNotificationSink::OnStatusChange restituisce lo stato della connessione. Per altre informazioni sulla registrazione per le notifiche, vedere IDot11AdHocManager.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2008 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | adhoc.h |