DOT11EXT_SET_DEFAULT_KEY コールバック関数 (wlanihv.h)

[アーティクル]
03/05/2024

大事なネイティブ 802.11 ワイヤレス LAN インターフェイスは、Windows 10 以降では非推奨となりました。代わりに WLAN デバイスドライバーインターフェイス (WDI) を使用してください。 WDI の詳細については、「 WLAN ユニバーサル Windows ドライバーモデル」を参照してください。

IHV Extensions DLL は Dot11ExtSetDefaultKey 関数を呼び出して、ワイヤレス LAN (WLAN) アダプターの既定のキーテーブルまたはステーションごとの既定のキーテーブルに対して暗号キーを追加または削除します。これらのキーの種類の詳細については、「 802.11 暗号キーの種類」を参照してください。

構文

DOT11EXT_SET_DEFAULT_KEY Dot11extSetDefaultKey;

DWORD Dot11extSetDefaultKey(
  [in, optional] HANDLE hDot11SvcHandle,
  [in]           PDOT11_CIPHER_DEFAULT_KEY_VALUE pKey,
  [in]           DOT11_DIRECTION dot11Direction
)
{...}

パラメーター

[in, optional] hDot11SvcHandle

オペレーティングシステムが WLAN アダプターを参照するために使用するハンドル。このハンドル値は、 Dot11ExtIhvInitAdapter IHV ハンドラー関数の以前の呼び出しによって指定されました。

[in] pKey

へのポインター DOT11_CIPHER_DEFAULT_KEY_VALUE 構造。暗号キーを定義します。

[in] dot11Direction

キーを受信パケット ( DOT11_DIR_INBOUND ) にのみ使用できるか、または受信パケットと送信パケットの両方 (DOT11_DIR_BOTH) に使用できるかを指定するDOT11_DIRECTION値。

メモ IHV 拡張機能 DLL は、このパラメーターに DOT11_DIR_OUTBOUND の値を渡す必要があります。

戻り値

呼び出しが成功した場合、関数はERROR_SUCCESSを返します。それ以外の場合は、Winerror.h で定義されたエラーコードが返されます。

注釈

Dot11ExtSetDefaultKey 関数を呼び出すと、オブジェクト識別子を WLAN アダプターにOID_DOT11_CIPHER_DEFAULT_KEYします。

既定の暗号キーは、の MacAddr メンバーを設定することによって定義されます。構造体を 0x000000000000 の値にDOT11_CIPHER_DEFAULT_KEY_VALUEします。ステーションごとの既定の暗号キーは、 MacAddr メンバーを有効なユニキャストメディアアクセス制御 (MAC) アドレスに設定することで定義されます。

の bDelete メンバーがアダプターのキーテーブルから暗号キーを削除する構造体DOT11_CIPHER_DEFAULT_KEY_VALUETRUE に設定されています。

要件

要件	値
サポートされている最小のクライアント	Windows Vista 以降のバージョンの Windows オペレーティングシステムで使用できます。
対象プラットフォーム	デスクトップ
Header	wlanihv.h (Wlanihv.h を含む)