Metodo IDot11AdHocManager::CommitCreatedNetwork (adhoc.h)

Articolo
02/23/2024

Inizializza una rete creata e, facoltativamente, esegue il commit del profilo della rete nell'archivio profili. La rete deve essere creata usando CreateNetwork prima di chiamare CommitCreatedNetwork.

Sintassi

HRESULT CommitCreatedNetwork(
  [in] IDot11AdHocNetwork *pIAdHoc,
  [in] BOOLEAN            fSaveProfile,
  [in] BOOLEAN            fMakeSavedProfileUserSpecific
);

Parametri

[in] pIAdHoc

Puntatore a un'interfaccia IDot11AdHocNetwork che specifica la rete da inizializzare e eseguire il commit.

[in] fSaveProfile

Parametro facoltativo che specifica se è necessario salvare 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 utente all-user. Se impostato su TRUE, il profilo è specifico dell'utente corrente. Se impostato su FALSE, il profilo è un profilo all-user 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 mantenere un profilo utente 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 rendere permanente un profilo utente all-user.

Se l'applicazione è in esecuzione in una finestra Desktop remoto, è possibile salvare solo un profilo utente all-user. 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 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.

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

IDot11AdHocManager

IDot11AdHocManager::CreateNetwork

Condividi tramite