IDot11AdHocNetwork::Connect-Methode (adhoc.h)

Artikel
08/22/2023

Stellt eine Verbindung mit einem zuvor erstellten drahtlosen Ad-hoc-Netzwerk her. Bevor eine Anwendung eine Verbindung mit einem Netzwerk herstellen kann, muss das Netzwerk mit IDot11AdHocManager::CreateNetwork erstellt und mithilfe von IDot11AdHocManager::CommitCreatedNetwork erstellt worden sein.

Syntax

HRESULT Connect(
  [in] LPCWSTR Passphrase,
  [in] LONG    GeographicalId,
  [in] BOOLEAN fSaveProfile,
  [in] BOOLEAN fMakeSavedProfileUserSpecific
);

Parameter

[in] Passphrase

Die Kennwortzeichenfolge, die zum Authentifizieren des Benutzers oder Computers im Netzwerk verwendet wird.

Die Länge der Kennwortzeichenfolge hängt von den Sicherheitseinstellungen ab, die im pSecurity-Parameter des CreateNetwork-Aufrufs übergeben werden. Die folgende Tabelle zeigt die Kennwortlänge, die verschiedenen Sicherheitseinstellungen zugeordnet ist.

Sicherheitseinstellungen	Kennwortlänge
Open-None	0
Open-WEP	5 oder 13 Zeichen; 10 oder 26 Hexadezimalstellen
WPA2PSK	8 bis 63 Zeichen

Die aufgezählten Werte, die dem obigen Sicherheitseinstellungspaar entsprechen, finden Sie unter DOT11_ADHOC_AUTH_ALGORITHM und DOT11_ADHOC_CIPHER_ALGORITHM.

[in] GeographicalId

Der geografische Standort, an dem das Netzwerk erstellt wurde. Eine Liste der möglichen Werte finden Sie unter Tabelle mit geografischen Standorten.

[in] fSaveProfile

Ein optionaler Parameter, der angibt, ob ein Drahtlosprofil gespeichert werden soll. Bei TRUE wird das Profil im Profilspeicher gespeichert. Sobald ein Profil gespeichert wurde, kann der Benutzer das Profil über die Benutzeroberfläche Drahtloses Netzwerk verwalten ändern. Profile können auch mithilfe der nativen WLAN-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 auf TRUE festgelegt ist, ist das Profil spezifisch für den aktuellen Benutzer. Wenn es auf FALSE festgelegt ist, ist das Profil ein Benutzerprofil, das von jedem benutzerseitig angemeldeten Benutzer verwendet werden kann. Dieser Parameter wird ignoriert, wenn fSaveProfilefalse ist.

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

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

Rückgabewert

Mögliche Rückgabewerte sind unter anderem folgendes:

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.

Hinweise

Diese Methode ist asynchron. Connect gibt S_OK sofort zurück, wenn die an die Methode übergebenen Parameter gültig sind. Ein Rückgabecode von S_OK gibt jedoch nicht an, dass die Verbindung erfolgreich war. Sie müssen sich für Benachrichtigungen auf der IDot11AdHocNetworkNotificationSink-Schnittstelle registrieren, um über einen Erfolgreichen oder Fehler der Verbindung benachrichtigt zu werden. Die IDot11AdHocNetworkNotificationSink::OnStatusChange-Methode gibt die Verbindung status zurück. Weitere Informationen zum Registrieren von Benachrichtigungen finden Sie unter IDot11AdHocManager.

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

IDot11AdHocNetwork

IDot11AdHocNetwork::D isconnect

Freigeben über