IDot11AdHocManager::CommitCreatedNetwork-Methode (adhoc.h)

Artikel
02/26/2024

Initialisiert ein erstelltes Netzwerk und committet optional das Netzwerkprofil in den Profilspeicher. Das Netzwerk muss mit CreateNetwork erstellt werden, bevor CommitCreatedNetwork aufgerufen wird.

Syntax

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

Parameter

[in] pIAdHoc

Ein Zeiger auf eine IDot11AdHocNetwork-Schnittstelle , die das zu initialisierende und committete Netzwerk angibt.

[in] fSaveProfile

Ein optionaler Parameter, der angibt, ob ein Drahtlosprofil gespeichert werden soll. Bei TRUE wird das Profil im Profilspeicher gespeichert. Nachdem ein Profil gespeichert wurde, kann der Benutzer das Profil über die Benutzeroberfläche Drahtlosnetzwerk verwalten ändern. Profile können auch mithilfe der nativen Wifi-Funktionen geändert werden.

Durch das Speichern eines Profils wird die von IDot11AdHocNetwork::GetSignature zurückgegebene Netzwerksignatur geändert.

[in] fMakeSavedProfileUserSpecific

Ein optionaler Parameter, der angibt, ob das zu speichernde Profil ein Benutzerprofil ist. Wenn true festgelegt ist, ist das Profil spezifisch für den aktuellen Benutzer. Wenn dieser Wert auf FALSE festgelegt ist, handelt es sich um ein Benutzerprofil, das von jedem benutzerseitig angemeldeten Benutzer verwendet werden kann. Dieser Parameter wird ignoriert, wenn fSaveProfileauf FALSE festgelegt ist.

Standardmäßig können nur Mitglieder der Gruppe Administratoren ein Benutzerprofil beibehalten. Diese Sicherheitseinstellungen können mithilfe der WlanSetSecuritySettings-Funktion geändert werden. Ihre Anwendung muss von einem Benutzer mit ausreichenden Berechtigungen gestartet werden, damit ein Benutzerprofil erfolgreich beibehalten werden kann.

Wenn Ihre Anwendung in einem Remotedesktopfenster ausgeführt wird, können Sie nur ein Benutzerprofil speichern. Benutzerspezifische Profile können nicht in einer Remoteanwendung gespeichert werden.

Rückgabewert

Mögliche Rückgabewerte sind u. a. die folgenden:

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich abgeschlossen.
E_FAIL	Fehler bei der Methode.
E_INVALIDARG	Einer der Parameter ist ungültig.
E_NOINTERFACE	Eine angegebene Schnittstelle wird nicht unterstützt.
E_OUTOFMEMORY	Die -Methode konnte den für diesen Vorgang erforderlichen Arbeitsspeicher nicht zuordnen.
E_POINTER	Ein als Parameter übergebener Zeiger ist ungültig.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	adhoc.h

Weitere Informationen

IDot11AdHocManager

IDot11AdHocManager::CreateNetwork

Freigeben über