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

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

 

IHV 拡張機能 DLL は、Dot11ExtSetDefaultKeyId 関数を呼び出して、送信されたパケット データを暗号化するときにワイヤレス LAN (WLAN) アダプターが既定で使用する既定またはステーションごとの暗号キーのテーブル インデックスを設定します。

構文

DOT11EXT_SET_DEFAULT_KEY_ID Dot11extSetDefaultKeyId;

DWORD Dot11extSetDefaultKeyId(
  [in, optional] HANDLE hDot11SvcHandle,
  [in]           ULONG uDefaultKeyId
)
{...}

パラメーター

[in, optional] hDot11SvcHandle

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

[in] uDefaultKeyId

アダプターの既定またはステーションごとの暗号キー テーブル内のキーのインデックス値。

WEP や TKIP などの標準の 802.11 暗号アルゴリズムの場合、uDefaultKeyId は 0 から 3 である必要があります。 IHV によって開発された独自の暗号アルゴリズムの場合、uDefaultKeyId は、IHV によって定義された範囲内の任意の値にすることができます。

戻り値

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

備考

既定のキー識別子 (ID) は、アダプターの既定のキー内の暗号キーのインデックスと、アダプターがデータ暗号化に使用するステーションごとの既定のキー テーブルを指定します。 アダプターは、転送先メディア アクセス制御 (MAC) アドレスにキー マッピング キーが存在しない限り、既定のキー ID によって参照される暗号キーを送信パケットの既定の暗号化キーとして使用します。 これらの暗号キーの種類の詳細については、「802.11 暗号キーの種類を参照してください。

Dot11ExtSetDefaultKeyId 関数を呼び出すと、オブジェクト識別子 (OID) をネイティブ 802.11 ミニポート ドライバーに OID_DOT11_CIPHER_DEFAULT_KEY_ID し、WLAN アダプターを管理します。

必要条件

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

関連項目

OID_DOT11_CIPHER_DEFAULT_KEY_ID

Dot11ExtIhvInitAdapter の

802.11 暗号キーの種類