共用方式為

WlanGetSecuritySettings 函式 (wlanapi.h)

  • 發行項

WlanGetSecuritySettings 函式會取得與可設定對象相關聯的安全性設定。

語法

DWORD WlanGetSecuritySettings(
  [in]            HANDLE                  hClientHandle,
  [in]            WLAN_SECURABLE_OBJECT   SecurableObject,
  [out, optional] PWLAN_OPCODE_VALUE_TYPE pValueType,
  [out]           LPWSTR                  *pstrCurrentSDDL,
  [out]           PDWORD                  pdwGrantedAccess
);

參數

[in] hClientHandle

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

[in] SecurableObject

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

[out, optional] pValueType

指定安全性設定來源 之WLAN_OPCODE_VALUE_TYPE 值的指標。

值 意義
wlan_opcode_value_type_set_by_group_policy
 安全性設定是由組策略所設定。
wlan_opcode_value_type_set_by_user
 安全性設定是由用戶所設定。 用戶可以呼叫 WlanSetSecuritySettings 來設定安全性設定。

[out] pstrCurrentSDDL

在輸入時，此參數必須是 NULL。

在輸出時，此參數會收到安全性描述符字串的指標，這個字元串會在函數調用成功時指定物件的安全性設定。 如需此字串的詳細資訊，請參閱 WlanSetSecuritySettings 函 式。

[out] pdwGrantedAccess

物件的存取遮罩。

值 意義
WLAN_READ_ACCESS
 呼叫端可以檢視對象的許可權。
WLAN_EXECUTE_ACCESS
 呼叫端可以從讀取和執行物件。 WLAN_EXECUTE_ACCESS與位 OR 組合的值相同WLAN_READ_ACCESS |WLAN_EXECUTE_ACCESS。
WLAN_WRITE_ACCESS
 呼叫端可以從物件讀取、執行和寫入物件。 WLAN_WRITE_ACCESS與位 OR 組合的值相同WLAN_READ_ACCESS |WLAN_EXECUTE_ACCESS |WLAN_WRITE_ACCESS。

傳回值

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

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

傳回碼 Description
ERROR_INVALID_PARAMETER
 參數不正確。 如果發生下列任一狀況，就會傳回此錯誤：
  • hClientHandle 為 NULL。
  • pstrCurrentSDDL 為 NULL。
  • pdwGrantedAccess 為 NULL。
  • SecurableObject 設定為大於或等於 WLAN_SECURABLE_OBJECT_COUNT ( 12) 的值。
ERROR_INVALID_HANDLE
 句柄無效。 如果在句柄數據表中找不到 hClientHandle 參數中指定的句柄，就會傳回此錯誤。
ERROR_ACCESS_DENIED
 呼叫端沒有足夠的許可權。
ERROR_NOT_SUPPORTED
 此函式是從不支援的平臺呼叫。 如果此函式是從具有SP3的Windows XP或Windows XP搭配SP2用戶端的無線LAN API 呼叫，則會傳回此值。

備註

如果函式成功，呼叫端會負責釋放配置給 pstrCurrentSDDL 參數所指向之安全性描述元字串的記憶體。 不再需要時，應該藉由呼叫 WlanFreeMemory 函式並傳入 pstrCurrentSDDL 參數來釋放安全性描述元字串的記憶體。

規格需求

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

另請參閱

原生 Wifi API 許可權

WlanFreeMemory

WlanSetSecuritySettings