Share via

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
 この関数は、サポートされていないプラットフォームから呼び出されました。 この値は、SP3 の Windows XP または SP2 クライアントを使用した Windows XP 用ワイヤレス LAN 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 を呼び出します。
ConvertSecurityDescriptorToStringSecurityDescriptor によって返される文字列は、WlanSetSecuritySettings を呼び出すときに strModifiedSDDL パラメーター値として使用できます。

要件

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

関連項目

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

WlanGetSecuritySettings