WlanOpenHandle-Funktion (wlanapi.h)
Die WlanOpenHandle-Funktion öffnet eine Verbindung mit dem Server.
Syntax
DWORD WlanOpenHandle(
[in] DWORD dwClientVersion,
PVOID pReserved,
[out] PDWORD pdwNegotiatedVersion,
[out] PHANDLE phClientHandle
);
Parameter
[in] dwClientVersion
Die höchste Version der WLAN-API, die vom Client unterstützt wird.
| Wert | Bedeutung |
|---|---|
|
Clientversion für Windows XP mit SP3 und Wlan-API für Windows XP mit SP2. |
|
Clientversion für Windows Vista und Windows Server 2008 |
pReserved
Für die zukünftige Verwendung reserviert. Muss auf NULL festgelegt werden.
[out] pdwNegotiatedVersion
Die Version der WLAN-API, die in dieser Sitzung verwendet wird. Dieser Wert ist in der Regel die höchste Version, die sowohl vom Client als auch vom Server unterstützt wird.
[out] phClientHandle
Ein Handle, das der Client in dieser Sitzung verwenden soll. Dieses Handle wird während der gesamten Sitzung von anderen Funktionen verwendet.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.
Wenn die Funktion fehlschlägt, kann der Rückgabewert einer der folgenden Rückgabecodes sein.
| Rückgabecode | Beschreibung |
|---|---|
|
pdwNegotiatedVersion ist NULL, phClientHandle ist NULL, oder pReserved ist nicht NULL. |
|
Fehler beim Zuweisen von Arbeitsspeicher zum Erstellen des Clientkontexts. |
|
Verschiedene Fehlercodes. |
|
Der Server hat zu viele Handles ausgegeben. |
Hinweise
Die von dwClientVersion und pdwNegotiatedVersion angegebene Versionsnummer ist eine zusammengesetzte Versionsnummer, die aus Haupt- und Nebenversionen besteht. Die Hauptversion wird durch das Wort mit niedriger Ordnung und die Nebenversion durch das Wort mit hoher Ordnung angegeben. Die Makros WLAN_API_VERSION_MAJOR(_v) und WLAN_API_VERSION_MINOR(_v) geben die Haupt- bzw. Nebenversionsnummern zurück. Sie können eine Versionsnummer mithilfe des Makros WLAN_API_MAKE_VERSION(_major, _minor)erstellen.
Windows XP mit SP3 und Wireless LAN API für Windows XP mit SP2: WlanOpenHandle gibt eine Fehlermeldung zurück, wenn der WZC-Dienst (Wireless Zero Configuration) nicht gestartet wurde oder der WZC-Dienst nicht reagiert.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista, Windows XP mit SP3 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | wlanapi.h (wlanapi.h einschließen) |
| Bibliothek | Wlanapi.lib |
| DLL | Wlanapi.dll |
| Verteilbare Komponente | Wlan-API für Windows XP mit SP2 |