Metodo IDot11AdHocManager::CreateNetwork (adhoc.h)

Articolo
02/23/2024

Crea una rete ad hoc wireless. Altri client e host possono connettersi a questa rete.

Sintassi

HRESULT CreateNetwork(
  [in]  LPCWSTR                     Name,
  [in]  LPCWSTR                     Password,
  [in]  LONG                        GeographicalId,
  [in]  IDot11AdHocInterface        *pInterface,
  [in]  IDot11AdHocSecuritySettings *pSecurity,
  [in]  GUID                        *pContextGuid,
  [out] IDot11AdHocNetwork          **pIAdHoc
);

Parametri

[in] Name

Nome descrittivo della rete. Questa stringa deve essere limitata a 32 caratteri. Il SSID deve essere usato come nome descrittivo. Questo nome viene trasmesso in un beacon.

[in] Password

Password usata per l'autenticazione del computer o dell'utente nella rete.

La lunghezza della stringa password dipende dalle impostazioni di sicurezza passate nel parametro pSecurity . Nella tabella seguente viene illustrata 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 corrispondenti alla coppia di impostazioni di sicurezza precedente, vedere DOT11_ADHOC_AUTH_ALGORITHM e DOT11_ADHOC_CIPHER_ALGORITHM

[in] GeographicalId

Posizione geografica in cui verrà creata la rete. Per un elenco dei valori possibili, vedere Tabella delle posizioni geografiche.

Se l'interfaccia non è conforme a 802.11, questo valore viene ignorato. Ciò significa che se IDot11AdHocInterface::IsDot11d restituisce FALSE, questo valore viene ignorato.

Se non si è certi del valore da usare, impostare GeographicalId su CTRY_DEFAULT. Se si usa CTRY_DEFAULT, la conformità 802.11d non viene applicata.

[in] pInterface

Puntatore facoltativo a un IDot11AdHocInterface che specifica l'interfaccia di rete in base alla quale viene creata la nuova rete. Se questo parametro è NULL, viene usata la prima interfaccia inutilizzata. Se tutte le interfacce sono in uso, viene usata la prima interfaccia enumerata. In tal caso, la rete precedente nell'interfaccia viene disconnessa.

[in] pSecurity

Puntatore a un'interfaccia IDot11AdHocSecuritySettings che specifica le impostazioni di sicurezza usate nella rete.

[in] pContextGuid

Parametro facoltativo che specifica il GUID dell'applicazione che ha creato la rete. Un'applicazione può usare questo identificatore per limitare le reti enumerate da GetIEnumDot11AdHocNetworks alle reti create dall'applicazione. Per il corretto funzionamento del filtro, tutte le istanze dell'applicazione in tutti i computer devono usare lo stesso GUID.

[out] pIAdHoc

Puntatore a un'interfaccia IDot11AdHocNetwork che rappresenta la rete creata.

Valore restituito

I valori restituiti possibili includono, ma non sono limitati a, quanto segue.

Codice restituito	Descrizione
S_OK	Metodo completato correttamente.
E_FAIL	Il metodo non è riuscito.
E_INVALIDARG	Uno dei parametri non è valido.
E_NOINTERFACE	Non è supportata un'interfaccia specificata.
E_OUTOFMEMORY	Impossibile allocare la memoria necessaria per eseguire questa operazione.
E_POINTER	Un puntatore passato come parametro non è valido.
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS)	Esiste già una rete con il nome specificato.
HRESULT_FROM_WIN32(ERROR_NOT_READY)	L'interfaccia pInterface segnala che la radio viene disattivata.
HRESULT_FROM_WIN32(ERROR_NOT_CAPABLE)	L'interfaccia pInterface segnala che non è in grado di formare una rete ad hoc. Questa condizione può verificarsi perché la scheda di interfaccia di rete non supporta reti ad hoc o perché la scheda di interfaccia di rete non supporta le impostazioni di sicurezza fornite da pSecurity.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	Le impostazioni pSecurity non sono supportate dall'interfaccia pInterface .
HRESULT_FROM_WIN32(ERROR_ILL_FORMED_PASSWORD)	La password specificata non è valida. La password fornita può essere una lunghezza non valida per le impostazioni di sicurezza fornite da pSecurity.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	Non è stata trovata una scheda di interfaccia di rete wireless nel computer.
HRESULT_FROM_WIN32(ERROR_CURRENT_DOMAIN_NOT_ALLOWED)	I criteri di gruppo o le impostazioni amministrative impediscono la creazione della rete.

Commenti

Dopo una chiamata CreateNetwork riuscita, l'oggetto di rete restituito da pIAdHoc viene effettuato il provisioning ma non costruito. Una chiamata successiva a CommitCreatedNetwork inizializza la rete. I beacon non vengono inviati finché non viene eseguito il commit della rete.

Non sono presenti client o host connessi alla rete dopo una chiamata CreateNetwork . Le applicazioni ricevono una notifica di tentativi di connessione riusciti e non riusciti usando l'interfaccia IDot11AdHocManagerNotificationSink . Per informazioni sulla registrazione per le notifiche in tale interfaccia, 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

Vedi anche

CommitCreatedNetwork

IDot11AdHocManager

Condividi tramite