共用方式為

WlanOpenHandle 函式 (wlanapi.h)

  • 發行項

WlanOpenHandle函式會開啟與伺服器的連線。

語法

DWORD WlanOpenHandle(
  [in]  DWORD   dwClientVersion,
        PVOID   pReserved,
  [out] PDWORD  pdwNegotiatedVersion,
  [out] PHANDLE phClientHandle
);

參數

[in] dwClientVersion

用戶端支援的最高 WLAN API 版本。

值 意義
1
 Windows XP 搭配 SP3 的用戶端版本，以及適用于 Windows XP SP2 的無線區域網路 API。
2
 Windows Vista 和 Windows Server 2008 的用戶端版本

pReserved

保留供未來使用。 必須設定為 Null。

[out] pdwNegotiatedVersion

將在此會話中使用的 WLAN API 版本。 此值通常是用戶端和伺服器所支援的最高版本。

[out] phClientHandle

要在此會話中使用的用戶端控制碼。 此控制碼會由整個會話中的其他函式使用。

傳回值

如果函式成功，傳回值會ERROR_SUCCESS。

如果函式失敗，傳回值可能是下列其中一個傳回碼。

傳回碼 描述
ERROR_INVALID_PARAMETER
 pdwNegotiatedVersion 為 Null、 phClientHandle 為 Null，或 pReserved 不是 Null。
ERROR_NOT_ENOUGH_MEMORY
 無法配置記憶體以建立用戶端內容。
RPC_STATUS
 各種錯誤碼。
ERROR_REMOTE_SESSION_LIMIT_EXCEEDED
 伺服器已發出太多控制碼。

備註

dwClientVersion和pdwNegotiatedVersion所指定的版本號碼是由主要和次要版本組成的複合版本號碼。 主要版本是由低順序字組所指定，而次要版本則由高序字組指定。 宏 WLAN_API_VERSION_MAJOR(_v) 和 WLAN_API_VERSION_MINOR(_v) 分別傳回主要和次要版本號碼。 您可以使用宏 WLAN_API_MAKE_VERSION(_major, _minor) 來建構版本號碼。

Windows XP with SP3 and Wireless LAN API for Windows XP with SP2： WlanOpenHandle會傳回錯誤訊息，如果無線零設定 (WZC) 服務尚未啟動，或 WZC 服務沒有回應。

規格需求

   
最低支援的用戶端 Windows Vista、Windows XP SP3 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 wlanapi.h (包含 Wlanapi.h)
程式庫 Wlanapi.lib
Dll Wlanapi.dll
可轉散發套件 Windows XP 搭配 SP2 的無線區域網路 API

另請參閱

WlanCloseHandle