共用方式為


WlanHostedNetworkSetProperty 函式 (wlanapi.h)

WlanHostedNetworkSetProperty 函式會設定無線託管網路的靜態屬性。

語法

DWORD WlanHostedNetworkSetProperty(
  [in]            HANDLE                      hClientHandle,
  [in]            WLAN_HOSTED_NETWORK_OPCODE  OpCode,
  [in]            DWORD                       dwDataSize,
  [in]            PVOID                       pvData,
  [out, optional] PWLAN_HOSTED_NETWORK_REASON pFailReason,
                  PVOID                       pvReserved
);

參數

[in] hClientHandle

用戶端的會話句柄,由先前呼叫 WlanOpenHandle 函式所傳回。

[in] OpCode

要設定之屬性的標識碼。 此識別碼只能是 Wlanapi.h 頭檔中所定義WLAN_HOSTED_NETWORK_OPCODE列舉中的下列值:

  • wlan_hosted_network_opcode_connection_settings

裝載的網路連線設定。

  • wlan_hosted_network_opcode_enable

已啟用託管網路旗標。

[in] dwDataSize

值,指定 pvData 參數所指向緩衝區的大小,以位元組為單位。

[in] pvData

要設定之靜態屬性的緩衝區指標。 與此緩衝區相關聯的數據類型取決於 OpCode 參數的值。

[out, optional] pFailReason

如果 WlanHostedNetworkSetProperty 函式的呼叫失敗,則為接收失敗原因之值的選擇性指標。 失敗原因的可能值來自 Wlanapi.h 頭檔中定義的WLAN_HOSTED_NETWORK_REASON列舉類型。

pvReserved

保留供未來使用。 此參數必須是 NULL

傳回值

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

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

傳回碼 Description
ERROR_ACCESS_DENIED
呼叫端沒有足夠的許可權。 如果 OpCode 參數 已wlan_hosted_network_opcode_enable ,而且網域上的組策略會停用無線裝載網路,也會傳回此錯誤。
ERROR_BAD_PROFILE
無線託管網路所使用的網路連線配置檔已損毀。
ERROR_INVALID_HANDLE
句柄無效。 如果在句柄數據表中找不到 hClientHandle 參數中指定的句柄,就會傳回此錯誤。
ERROR_INVALID_PARAMETER
參數不正確。 如果發生下列任一狀況,就會傳回此錯誤:
  • hClientHandleNULL
  • OpCode 不是 WLAN_HOSTED_NETWORK_OPCODE中定義的其中一個列舉值。
  • dwDataSize 為零。
  • pvDataNULL
  • pvData 不會指向格式正確的靜態屬性。
  • pvReserved 不是 NULL
ERROR_INVALID_STATE
資源未處於執行要求作業的正確狀態。 如果無線託管網路正在進行關機,就會發生這種情況。
ERROR_NOT_SUPPORTED
不支援此要求。 如果應用程式呼叫 WlanHostedNetworkSetProperty 函式,並將 OpCode 參數設定為 wlan_hosted_network_opcode_station_profilewlan_hosted_network_opcode_security_settings,就會傳回此錯誤。
ERROR_SERVICE_NOT_ACTIVE
尚未啟動服務。 如果WLAN自動設定服務未執行,則會傳回此錯誤。
其他
各種 RPC 和其他錯誤碼。 使用 FormatMessage 取得傳回錯誤的訊息字串。

備註

WlanHostedNetworkSetProperty 函式是新增的原生無線 API 擴充功能,可支援 Windows 7 和 Windows Server 2008 R2 上安裝無線 LAN 服務的無線託管網路。

用戶端應用程式會呼叫 WlanHostedNetworkSetProperty 函式 ,以設定無線託管網路的目前靜態屬性。 如果呼叫應用程式使用 hClientHandle 參數 (呼叫 WlanCloseHandle ,) 或進程結束,呼叫 WlanCloseHandle ,則不會自動復原此函式所造成的任何裝載網路屬性變更。

與 pvData 參數所指向之緩衝區相關聯的數據類型取決於 OpCode 參數的值,如下所示:

OpCode Description
wlan_hosted_network_opcode_connection_settings WLAN_HOSTED_NETWORK_CONNECTION_SETTINGS 結構的指標會在 pvData 參數中傳遞。
wlan_hosted_network_opcode_enable BOOL 的指標會在 pvData 參數中傳遞。
 

如果 呼叫 WlanHostedNetworkSetProperty 函式, 並將 OpCode 參數設定為 wlan_hosted_network_opcode_enable,用戶必須具有適當的相關聯許可權。 許可權會儲存在與 WLAN_SECURABLE_OBJECT相關聯的 DACL) (任意存取控制清單中。 若要使用 wlan_hosted_network_opcode_enable 的 OpCode 參數呼叫 WlanHostedNetworkSetProperty 函式,呼叫端的用戶端存取令牌必須具有下列列舉所公開的提高許可權WLAN_SECURABLE_OBJECT

  • wlan_secure_hosted_network_elevated_access

如果 WlanHostedNetworkSetProperty 函式在 OpCode 參數中傳遞下列任何值,此函式將會失敗,並 ERROR_NOT_SUPPORTED

  • wlan_hosted_network_opcode_station_profile
  • wlan_hosted_network_opcode_connection_settings

為了成功, WlanHostedNetworkSetProperty 函式必須保存新的設定,這需要裝載的網路狀態在目前執行 (wlan_hosted_network_active) 時轉換為 wlan_hosted_network_idle

任何使用者可以呼叫此函式來設定裝載的網路屬性。 不過,若要設定 wlan_hosted_network_opcode_enable 旗標,需要提高的許可權。 啟用無線託管網路的能力也可能受限於網域中的組策略。

在 Windows 7 和更新版本上,如果電腦上存在支援託管網路的無線適配卡,操作系統就會安裝虛擬設備。 如果計算機具有單一無線網路適配卡,此虛擬設備通常會在「網路 Connections 資料夾」中顯示為「無線網路連線 2」,且裝置名稱為 「Microsoft Virtual WiFi Miniport 配接器」。 此虛擬設備專門用來執行軟體存取點 (SoftAP) 連線,而且不會出現在 WlanEnumInterfaces 函式所傳回的清單中。 此虛擬設備的存留期會系結至實體無線適配卡。 如果實體無線適配卡已停用,也會移除此虛擬設備。 此功能也適用於已安裝無線 LAN 服務的 Windows Server 2008 R2。

規格需求

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

另請參閱

關於無線託管網路

使用無線託管網路和因特網聯機共用

WLAN_HOSTED_NETWORK_CONNECTION_SETTINGS

WLAN_HOSTED_NETWORK_OPCODE

WLAN_HOSTED_NETWORK_REASON

WlanCloseHandle

WlanEnumInterfaces

WlanHostedNetworkInitSettings

WlanHostedNetworkQueryProperty

WlanHostedNetworkQuerySecondaryKey

WlanHostedNetworkRefreshSecuritySettings

WlanHostedNetworkSetSecondaryKey

WlanOpenHandle