IDot11AdHocManager::CreateNetwork-Methode (adhoc.h)

Artikel
08/22/2023

Erstellt ein drahtloses Ad-hoc-Netzwerk. Andere Clients und Hosts können eine Verbindung mit diesem Netzwerk herstellen.

Syntax

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

Parameter

[in] Name

Der Anzeigename des Netzwerks. Diese Zeichenfolge sollte auf 32 Zeichen beschränkt sein. Die SSID sollte als Anzeigename verwendet werden. Dieser Name wird in einem Beacon übertragen.

[in] Password

Das Kennwort, das für die Computer- oder Benutzerauthentifizierung im Netzwerk verwendet wird.

Die Länge der Kennwortzeichenfolge hängt von den Sicherheitseinstellungen ab, die im pSecurity-Parameter ü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 wird. Eine Liste der möglichen Werte finden Sie unter Tabelle mit geografischen Standorten.

Wenn die Schnittstelle nicht 802.11d-konform ist, wird dieser Wert ignoriert. Das bedeutet, wenn IDot11AdHocInterface::IsDot11dFALSE zurückgibt, wird dieser Wert ignoriert.

Wenn Sie nicht sicher sind, welcher Wert verwendet werden soll, legen Sie GeographicalId auf CTRY_DEFAULT fest. Wenn Sie CTRY_DEFAULT verwenden, wird die 802.11d-Konformität nicht erzwungen.

[in] pInterface

Ein optionaler Zeiger auf ein IDot11AdHocInterface , das die Netzwerkschnittstelle angibt, auf der das neue Netzwerk erstellt wird. Wenn dieser Parameter NULL ist, wird die erste nicht verwendete Schnittstelle verwendet. Wenn alle Schnittstellen verwendet werden, wird die erste aufgezählte Schnittstelle verwendet. In diesem Fall wird das vorherige Netzwerk auf der Schnittstelle getrennt.

[in] pSecurity

Ein Zeiger auf eine IDot11AdHocSecuritySettings-Schnittstelle , die die im Netzwerk verwendeten Sicherheitseinstellungen angibt.

[in] pContextGuid

Ein optionaler Parameter, der die GUID der Anwendung angibt, die das Netzwerk erstellt hat. Eine Anwendung kann diesen Bezeichner verwenden, um die von GetIEnumDot11AdHocNetworks aufgelisteten Netzwerke auf Netzwerke zu beschränken, die von der Anwendung erstellt wurden. Damit diese Filterung ordnungsgemäß funktioniert, müssen alle Instanzen der Anwendung auf allen Computern dieselbe GUID verwenden.

[out] pIAdHoc

Ein Zeiger auf eine IDot11AdHocNetwork-Schnittstelle , die das erstellte Netzwerk darstellt.

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.
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS)	Ein Netzwerk mit dem angegebenen Namen ist bereits vorhanden.
HRESULT_FROM_WIN32(ERROR_NOT_READY)	Die pInterface-Schnittstelle meldet, dass ihr Funkgerät ausgeschaltet ist.
HRESULT_FROM_WIN32(ERROR_NOT_CAPABLE)	Die pInterface-Schnittstelle meldet, dass sie kein Ad-hoc-Netzwerk bilden kann. Diese Bedingung kann auftreten, weil die NIC keine Ad-hoc-Netzwerke unterstützt oder weil die NIC die von pSecurity bereitgestellten Sicherheitseinstellungen nicht unterstützt.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	Die pSecurity-Einstellungen werden von der pInterface-Schnittstelle nicht unterstützt.
HRESULT_FROM_WIN32(ERROR_ILL_FORMED_PASSWORD)	Das angegebene Kennwort ist ungültig. Das angegebene Kennwort kann eine ungültige Länge für die von pSecurity bereitgestellten Sicherheitseinstellungen aufweisen.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	Eine drahtlose Netzwerkschnittstelle Karte wurde auf dem Computer nicht gefunden.
HRESULT_FROM_WIN32(ERROR_CURRENT_DOMAIN_NOT_ALLOWED)	Gruppenrichtlinien oder administrative Einstellungen verhindern die Erstellung des Netzwerks.

Hinweise

Nach einem erfolgreichen CreateNetwork-Aufruf wird das von pIAdHoc zurückgegebene Netzwerkobjekt zwar bereitgestellt, aber nicht erstellt. Ein nachfolgender Aufruf von CommitCreatedNetwork initialisiert das Netzwerk. Beacons werden erst gesendet, wenn das Netzwerk zugesagt wurde.

Nach einem CreateNetwork-Aufruf sind keine Clients oder Hosts mit dem Netzwerk verbunden. Anwendungen werden über erfolgreiche und fehlgeschlagene Verbindungsversuche über die IDot11AdHocManagerNotificationSink-Schnittstelle benachrichtigt. Informationen zum Registrieren von Benachrichtigungen auf dieser Schnittstelle 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

CommitCreatedNetwork

IDot11AdHocManager

Freigeben über