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

大事なネイティブ 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) を、WLAN アダプターを管理する Native 802.11 ミニポート ドライバーにOID_DOT11_CIPHER_DEFAULT_KEY_IDします。

要件

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

こちらもご覧ください

OID_DOT11_CIPHER_DEFAULT_KEY_ID

Dot11ExtIhvInitAdapter

802.11 暗号キーの種類