共用方式為

WlanQueryAutoConfigParameter 函式 (wlanapi.h)

  • 發行項

WlanQueryAutoConfigParameter 函式會查詢自動設定服務的參數。

語法

DWORD WlanQueryAutoConfigParameter(
  [in]            HANDLE                  hClientHandle,
  [in]            WLAN_AUTOCONF_OPCODE    OpCode,
                  PVOID                   pReserved,
  [out]           PDWORD                  pdwDataSize,
  [out]           PVOID                   *ppData,
  [out, optional] PWLAN_OPCODE_VALUE_TYPE pWlanOpcodeValueType
);

參數

[in] hClientHandle

用戶端的會話句柄，由先前呼叫 WlanOpenHandle 函式取得。

[in] OpCode

值，指定要查詢的組態參數。

值 意義
wlan_autoconf_opcode_show_denied_networks
 設定時， ppData 參數會包含 BOOL 值，指出可用網路清單中是否將包含使用者和組策略拒絕的網路。

如果函式傳回ERROR_SUCCESS，且 ppData 指向 TRUE，則可用網路清單中將會包含使用者和組策略拒絕的網路;如果 為 FALSE，則不會在可用的網路清單中包含使用者和組策略拒絕的網路。
wlan_autoconf_opcode_power_setting
 設定時， ppData 參數會包含指定電源設定 的WLAN_POWER_SETTING 值。
wlan_autoconf_opcode_only_use_gp_profiles_for_allowed_networks
 設定時， ppData 參數將包含 BOOL 值，指出組策略未建立的配置檔是否可用來連線到具有相符組策略配置檔的允許網路。

如果函式傳回ERROR_SUCCESS，且 ppData 指向 TRUE，則只能使用組策略所建立的配置檔;如果 為 FALSE，則可以使用任何配置檔。
wlan_autoconf_opcode_allow_explicit_creds
 設定時， ppData 參數會包含 BOOL 值，指出目前的無線介面是否允許共用用戶認證。

如果函式傳回ERROR_SUCCESS，且 ppData 指向 TRUE，則目前的無線介面已允許共用用戶認證;如果 為 FALSE，則目前的無線介面不允許共用用戶認證。
wlan_autoconf_opcode_block_period
 設定時， ppData 參數會包含 DWORD 值，指出目前無線介面的封鎖期間設定。 封鎖的期間是前一次失敗之後，不會嘗試自動連線到無線網路的時間量，以秒為單位。
wlan_autoconf_opcode_allow_virtual_station_extensibility
 設定時， ppData 參數會包含 BOOL 值，指出是否允許虛擬站上的擴充性。 根據預設，允許虛擬網路上的擴充性。 此 opcode 的值會在重新啟動時保存。

如果函式傳回ERROR_SUCCESS，且 ppData 指向 TRUE，則允許虛擬站上的擴充性;如果 為 FALSE，則不允許虛擬網路上的擴充性。

pReserved

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

[out] pdwDataSize

指定 ppData 參數的大小，以位元組為單位。

[out] ppData

記憶體的指標，其中包含 OpCode中所指定參數的查詢值。

注意 如果 OpCode 設定為 wlan_autoconf_opcode_show_denied_networks， 則 ppData 所參考的指標可能會指向整數值。 如果 ppData 所參考的指標指向 0，則整數值應該轉換成布爾值 FALSE。 如果 ppData 所參考的指標指向非零整數，則整數值應該轉換成布爾值 TRUE。
 

[out, optional] pWlanOpcodeValueType

WLAN_OPCODE_VALUE_TYPE值。

傳回值

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

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

傳回碼 Description
ERROR_ACCESS_DENIED
 呼叫端沒有足夠的許可權可取得組態參數。

使用 OpCode 設定為 wlan_autoconf_opcode_show_denied_networks 呼叫時， WlanQueryAutoConfigParameter 會擷取使用 wlan_secure_show_denied 物件儲存的任意存取控制清單 (DACL) 。 如果 DACL 不包含存取控制專案， (ACE) 授與呼叫線程存取令牌的WLAN_READ_ACCESS許可權， 則 WlanQueryAutoConfigParameter 會傳回 ERROR_ACCESS_DENIED。
ERROR_INVALID_PARAMETER
 hClientHandle 為 NULL 或無效， pReserved 不是 NULL、 ppData 為 NULL，或 pdwDataSize 為 NULL。
ERROR_INVALID_HANDLE
 句柄數據表中找不到句柄 hClientHandle 。
ERROR_NOT_SUPPORTED
 從不支援的平臺呼叫此函式。 如果使用SP2用戶端從具有SP3的Windows XP或適用於Windows XP的無線LAN API 呼叫此函式，將會傳回此值。
RPC_STATUS
 各種錯誤碼。

備註

WlanQueryAutoConfigParameter 函式會查詢自動設定模組 (ACM) 所使用的參數，這是 Windows Vista 和更新版本支援的無線設定元件。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 wlanapi.h (包含 Wlanapi.h)
程式庫 Wlanapi.lib
Dll Wlanapi.dll

另請參閱

WLAN_AUTOCONF_OPCODE

WlanSetAutoConfigParameter