共用方式為

WlanSetSecuritySettings 函式 (wlanapi.h)

  • 發行項

WlanGetProfileList函式會設定可設定物件的安全性設定。

語法

DWORD WlanSetSecuritySettings(
  [in] HANDLE                hClientHandle,
  [in] WLAN_SECURABLE_OBJECT SecurableObject,
  [in] LPCWSTR               strModifiedSDDL
);

參數

[in] hClientHandle

用戶端的會話控制碼，由先前呼叫 WlanOpenHandle 函式取得。

[in] SecurableObject

WLAN_SECURABLE_OBJECT值，指定將套用安全性設定的物件。

[in] strModifiedSDDL

指定 物件之新安全性設定的安全性描述元字串。 此字串必須以 Null 結束。 如需詳細資訊，請參閱＜備註＞一節。

傳回值

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

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

傳回碼 描述
ERROR_INVALID_PARAMETER
 參數不正確。 如果發生下列任一情況，就會傳回此錯誤：
  • hClientHandle 為 Null。
  • strModifiedSDDL 為 Null。
  • SecurableObject 設定為大於或等於 WLAN_SECURABLE_OBJECT_COUNT ( 12) 的值。
ERROR_INVALID_HANDLE
 控制碼無效。 如果在控制碼資料表中找不到 hClientHandle 參數中指定的控制碼，就會傳回此錯誤。
ERROR_ACCESS_DENIED
 呼叫端沒有足夠的許可權。
ERROR_NOT_SUPPORTED
 從不支援的平臺呼叫此函式。 如果使用 SP2 用戶端從具有 SP3 的 Windows XP 或適用于 Windows XP 的無線區域網路 API 呼叫此函式，將會傳回此值。

備註

成功呼叫 WlanSetSecuritySettings函式會覆寫與 物件相關聯的預設許可權。 如需預設許可權的詳細資訊，請參閱 原生 Wifi API 許可權。

下列說明建立安全性描述元物件的程式，並將它剖析為字串。

  1. 呼叫 InitializeSecurityDescriptor 以在記憶體中建立安全性描述元。
  2. 呼叫 SetSecurityDescriptorOwner 來設定安全性描述元的擁有者資訊。
  3. 呼叫 InitializeAcl 以在記憶體中建立 DACL) (任意存取控制清單。
  4. 呼叫 AddAccessAllowedAce 或 AddAccessDeniedAce ，將存取控制專案新增至 DACL (ACE) 。 視需要將 AccessMask 參數設定為下列其中一個位 OR 組合：
    • WLAN_READ_ACCESS
    • WLAN_READ_ACCESS |WLAN_EXECUTE_ACCESS
    • WLAN_READ_ACCESS |WLAN_EXECUTE_ACCESS |WLAN_WRITE_ACCESS
  5. 呼叫 SetSecurityDescriptorDacl ，將 DACL 新增至安全性描述元。
  6. 呼叫 ConvertSecurityDescriptorToStringSecurityDescriptor ，將描述元轉換成字串。
呼叫WlanSetSecuritySettings時，ConvertSecurityDescriptorToStringSecurityDescriptor所傳回的字串可以當做strModifiedSDDL參數值使用。

規格需求

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

另請參閱

原生 Wifi API 許可權

WlanGetSecuritySettings