WlanOpenHandle-Funktion (wlanapi.h)

  • Artikel

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
1
 Clientversion für Windows XP mit SP3 und Wlan-API für Windows XP mit SP2.
2
 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
ERROR_INVALID_PARAMETER
 pdwNegotiatedVersion ist NULL, phClientHandle ist NULL, oder pReserved ist nicht NULL.
ERROR_NOT_ENOUGH_MEMORY
 Fehler beim Zuweisen von Arbeitsspeicher zum Erstellen des Clientkontexts.
RPC_STATUS
 Verschiedene Fehlercodes.
ERROR_REMOTE_SESSION_LIMIT_EXCEEDED
 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

Weitere Informationen

WlanCloseHandle