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