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

[アーティクル]
02/07/2025

重要Native 802.11 ワイヤレス LAN インターフェイスは、Windows 10 以降では非推奨です。代わりに WLAN デバイスドライバーインターフェイス (WDI) を使用してください。 WDI の詳細については、WLAN ユニバーサル Windows ドライバーモデルを参照してください。

IHV 拡張機能 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_VALUE 構造体は TRUE に設定されます。

必要条件

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

次の方法で共有

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

構文

パラメーター

戻り値

備考

必要条件

関連項目

フィードバック

その他のリソース