共用方式為

WlanSetAutoConfigParameter 函式 (wlanapi.h)

  • 發行項

WlanSetAutoConfigParameter 函式會設定自動設定服務的參數。

語法

DWORD WlanSetAutoConfigParameter(
  [in] HANDLE               hClientHandle,
  [in] WLAN_AUTOCONF_OPCODE OpCode,
  [in] DWORD                dwDataSize,
  [in] const PVOID          pData,
       PVOID                pReserved
);

參數

[in] hClientHandle

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

[in] OpCode

WLAN_AUTOCONF_OPCODE值，指定要設定的參數。 只有 WLAN_AUTOCONF_OPCODE 列舉中的部分 opcode 支援集合作業。

值 意義
wlan_autoconf_opcode_show_denied_networks
 設定時， pData 參數會包含 BOOL 值，指出是否要在可用的網路清單中包含使用者和組策略拒絕的網路。
wlan_autoconf_opcode_allow_explicit_creds
 設定時， pData 參數將包含 BOOL 值，指出目前的無線介面是否允許共用用戶認證。
wlan_autoconf_opcode_block_period
 設定時， pData 參數會包含目前無線介面之封鎖期間設定的 DWORD 值。 封鎖的期間是先前失敗之後，不會嘗試自動連線到無線網路的時間量，以秒為單位。
wlan_autoconf_opcode_allow_virtual_station_extensibility
 設定時， pData 參數會包含 BOOL 值，指出是否允許虛擬站臺上的擴充性。 根據預設，允許虛擬網路上的擴充性。 此 opcode 的值會在重新啟動時保存。

Windows 7 和已安裝無線 LAN 服務的 Windows Server 2008 R2 支援這個列舉值。

[in] dwDataSize

pData 參數的大小，以位元組為單位。 此參數必須針對 BOOL 或 sizeof(DWORD) DWORD 設定sizeof(BOOL)為 ，視 OpCode 參數的值而定。

[in] pData

要為 OpCode 參數中指定的參數設定的值。 根據 OpCode 參數的值，pData 參數必須指向布爾值或 DWORD 值。 pData 參數不得為 NULL。

注意 當需要布爾值時， pData 參數可能會指向整數值。 如果 pData 指向 0，則值會轉換成 FALSE。 如果 pData 指向非零整數，則值會轉換成 TRUE。
 

pReserved

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

傳回值

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

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

傳回碼 Description
ERROR_ACCESS_DENIED
 存取遭到拒絕。 如果呼叫端沒有足夠的許可權可設定組態參數，當 OpCode 參數wlan_autoconf_opcode_show_denied_networks或wlan_autoconf_opcode_allow_virtual_station_extensibility時，就會傳回此錯誤。 當 OpCode 參數設定為下列其中一個值時， WlanSetAutoConfigParameter 函式會擷取儲存給 opcode 物件的任意存取控制清單 (DACL) 。 如果 DACL 不包含存取控制專案 (ACE) 授與呼叫線程之存取令牌的WLAN_WRITE_ACCESS許可權， 則 WlanSetAutoConfigParameter 會傳回 ERROR_ACCESS_DENIED。

如果組態參數是由網域上的組策略所設定，也會傳回此錯誤。 針對 opcode 設定組策略時，會防止應用程式進行變更。 針對下列 OpCode 參數，可由組策略設定：wlan_autoconf_opcode_show_denied_networks、wlan_autoconf_opcode_allow_explicit_creds和wlan_autoconf_opcode_block_period
ERROR_INVALID_PARAMETER
 參數不正確。 如果 hClientHandle 參數為 NULL、pData 參數為 NULL，或 pReserved 參數不是 NULL，則會傳回此錯誤。 如果指定的 OpCode 參數不是可設定之組態參數的其中一個 WLAN_AUTOCONF_OPCODE 值，也會傳回此錯誤。 如果 dwDataSize 參數未設定為 sizeof(BOOL)，或 dwDataSize 不會根據 OpCode 參數的值設定為 sizeof(BOOL) ，也會傳回此錯誤。
ERROR_INVALID_HANDLE
 句柄數據表中找不到句柄 hClientHandle 。
ERROR_NOT_SUPPORTED
 此函式是從不支援的平臺呼叫。 如果此函式是從具有SP3的Windows XP或Windows XP搭配SP2用戶端的無線LAN API 呼叫，則會傳回此值。
RPC_STATUS
 各種錯誤碼。

備註

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

根據 OpCode 參數的值， pData 所指向的數據將會在設定自動設定參數之前轉換成布爾值。 如果 pData 指向 0，則 參數會設定為 FALSE;否則，參數會設定為 TRUE。

規格需求

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

另請參閱

WLAN_AUTOCONF_OPCODE

WlanQueryAutoConfigParameter