Share via

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 です。

関数が失敗した場合、戻り値は次のいずれかのリターン コードになります。

リターン コード 説明
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 または SP2 クライアントを使用した Windows XP 用ワイヤレス LAN API からこの関数が呼び出された場合に返されます。

注釈

呼び出し元は、関数が成功した場合に pstrCurrentSDDL パラメーターによって指されるセキュリティ記述子文字列に割り当てられたメモリを解放する役割を担います。 不要になったら、 WlanFreeMemory 関数を呼び出して pstrCurrentSDDL パラメーターを渡すことで、セキュリティ記述子文字列のメモリを解放する必要があります。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー wlanapi.h (Wlanapi.h を含む)
Library Wlanapi.lib
[DLL] Wlanapi.dll

こちらもご覧ください

ネイティブ Wifi API のアクセス許可

WlanFreeMemory

WlanSetSecuritySettings