ONEX_CONNECTION_PROFILE構造体
ONEX_CONNECTION_PROFILE構造体には、現在 802.1X 認証に使用されている 802.1X 接続プロファイルに関する情報が含まれています。
構文
typedef struct _ONEX_CONNECTION_PROFILE {
DWORD dwVersion;
DWORD dwTotalLen;
DWORD fOneXSupplicantFlags :1;
DWORD fsupplicantMode :1;
DWORD fauthMode :1;
DWORD fHeldPeriod :1;
DWORD fAuthPeriod :1;
DWORD fStartPeriod :1;
DWORD fMaxStart :1;
DWORD fMaxAuthFailures :1;
DWORD fNetworkAuthTimeout :1;
DWORD fAllowLogonDialogs :1;
DWORD fNetworkAuthWithUITimeout :1;
DWORD fUserBasedVLan :1;
DWORD dwOneXSupplicantFlags;
ONEX_SUPPLICANT_MODE supplicantMode;
ONEX_AUTH_MODE authMode;
DWORD dwHeldPeriod;
DWORD dwAuthPeriod;
DWORD dwStartPeriod;
DWORD dwMaxStart;
DWORD dwMaxAuthFailures;
DWORD dwNetworkAuthTimeout;
DWORD dwNetworkAuthWithUITimeout;
BOOL bAllowLogonDialogs;
BOOL bUserBasedVLan;
} ONEX_CONNECTION_PROFILE, *PONEX_CONNECTION_PROFILE;
メンバー
-
dwVersion
-
この ONEX_CONNECTION_PROFILE 構造体のバージョン。
-
dwTotalLen
-
この ONEX_CONNECTION_PROFILE 構造体の長さ (バイト単位)。
-
fOneXSupplicantFlags
-
ONEX_CONNECTION_PROFILE構造体に dwOneXSupplicantFlags メンバー内の有効なデータが含まれているかどうかを示します。
-
fsupplicantMode
-
ONEX_CONNECTION_PROFILE構造体に、supplicantMode メンバー内の有効なデータが含まれているかどうかを示します。
-
fauthMode
-
ONEX_CONNECTION_PROFILE構造体に authMode メンバー内の有効なデータが含まれているかどうかを示します。
-
fHeldPeriod
-
ONEX_CONNECTION_PROFILE構造体に dwHeldPeriod メンバー内の有効なデータが含まれているかどうかを示します。
-
fAuthPeriod
-
ONEX_CONNECTION_PROFILE構造体に dwAuthPeriod メンバー内の有効なデータが含まれているかどうかを示します。
-
fStartPeriod
-
ONEX_CONNECTION_PROFILE構造体に dwStartPeriod メンバーの有効なデータが含まれているかどうかを示します。
-
fMaxStart
-
ONEX_CONNECTION_PROFILE構造体に dwMaxStart メンバー内の有効なデータが含まれているかどうかを示します。
-
fMaxAuthFailures
-
ONEX_CONNECTION_PROFILE構造体に dwMaxAuthFailures メンバー内の有効なデータが含まれているかどうかを示します。
-
fNetworkAuthTimeout
-
ONEX_CONNECTION_PROFILE構造体に dwNetworkAuthTimeout メンバーの有効なデータが含まれているかどうかを示します。
-
fAllowLogonDialogs
-
ONEX_CONNECTION_PROFILE構造体に bAllowLogonDialogs メンバー内の有効なデータが含まれているかどうかを示します。
-
fNetworkAuthWithUITimeout
-
ONEX_CONNECTION_PROFILE構造体に dwNetworkAuthWithUITimeout メンバー内の有効なデータが含まれているかどうかを示します。
-
fUserBasedVLan
-
ONEX_CONNECTION_PROFILE構造体に bUserBasedVLan メンバー内の有効なデータが含まれているかどうかを示します。
-
dwOneXSupplicantFlags
-
プロファイルに存在できる 802.1X フラグのセット。 これらのフラグは、802.1X 認証モジュールによって内部で使用するために予約されています。
-
supplicantMode
-
メッセージに使用される転送方法を指定する 802.1X スキーマの supplicantMode 要素EAPOL-Start。 詳細については、802.1X スキームの supplicantMode (OneX) 要素 を参照してください。
値 説明 - OneXSupplicantModeInhibitTransmission
- 0
EAPOL-Startメッセージは送信されません。 有線 LAN プロファイルにのみ有効です。 - OneXSupplicantModeLearn
- 1
クライアントは、ネットワーク機能に基づいてEAPOL-Startパケットを送信するタイミングを決定します。 EAPOL-Startメッセージは、必要な場合にのみ送信されます。 有線 LAN プロファイルにのみ有効です。 - OneXSupplicantModeCompliant
- 2
EAPOL-Startメッセージは、802.1X で指定されたとおりに送信されます。 有線 LAN プロファイルとワイヤレス LAN プロファイルの両方に対して有効です。 -
authMode
-
802.1X 認証に使用される資格情報の種類を指定する 802.1X スキーマの authMode 要素。 詳細については、802.1X スキームの authMode (OneX) 要素 を参照してください。
値 説明 - OneXAuthModeMachineOrUser
- 0
コンピューターまたはユーザーの資格情報を使用します。 ユーザーがログオンすると、ユーザーの資格情報が認証に使用されます。 ユーザーがログオンしていない場合は、コンピューターの資格情報が使用されます。 - OneXAuthModeMachineOnly
- 1
コンピューターの資格情報のみを使用します。 - OneXAuthModeUserOnly
- 2
ユーザー資格情報のみを使用します。 - OneXAuthModeGuest
- 3
ゲスト (空) の資格情報のみを使用します。 - OneXAuthModeUnspecified
- 4
使用する資格情報は指定されていません。 -
dwHeldPeriod
-
認証試行の失敗後にクライアントが認証を再試行しない時間 (秒単位) を指定する 802.1X スキーマの heldPeriod 要素。 詳細については、802.1X スキームの heldPeriod (OneX) 要素 を参照してください。
-
dwAuthPeriod
-
クライアントが認証子からの応答を待機する最大時間 (秒単位) を指定する 802.1X スキーマの authPeriod 要素。 指定した期間内に応答が受信されない場合、クライアントは、ネットワーク上に認証子が存在しないと見なします。 詳細については、802.1X スキームの authPeriod (OneX) 要素 を参照してください。
-
dwStartPeriod
-
802.1X スキーマの startPeriod 要素。EAPOL-Startが送信されるまでの待機時間を秒単位で指定します。 EAPOL-Start メッセージが送信され、802.1X 認証プロセスが開始されます。 詳細については、802.1X スキームの startPeriod (OneX) 要素 を参照してください。
-
dwMaxStart
-
送信されるメッセージの最大数を指定する 802.1X スキーマの maxStart 要素EAPOL-Start。 EAPOL-Startメッセージの最大数が送信されると、クライアントはネットワークに認証子が存在しないものとします。 詳細については、802.1X スキームの maxStart (OneX) 要素 を参照してください。
-
dwMaxAuthFailures
-
802.1X スキーマの maxAuthFailures 要素。一連の資格情報に対して許可される認証エラーの最大数を指定します。 詳細については、 802.1X スキーマの maxAuthFailures (OneX) 要素を参照してください。
-
dwNetworkAuthTimeout
-
通常のログオンが続行されるまでの 802.1X 認証の完了を待機する時間 (秒単位)。 この値は、シングル サインオン (SSO) のシナリオで使用されます。 この値の既定値は、802.1X プロファイルでは 10 秒です。 詳細については、802.1X スキーマの maxDelay (singleSignOn) 要素 を参照してください。
-
dwNetworkAuthWithUITimeout
-
ログオンごとの SSO 中にユーザー入力を必要とするユーザー インターフェイス ダイアログ ボックスが表示された場合に、接続を待機する最大時間 (秒単位)。
SP1 以降の Windows Vista では、この値は 10 分にハードコーディングされ、構成できません。 Windows Vista Release to Manufacturing では、この値の既定値は 802.1X プロファイルで 60 秒に設定され、スキーマの maxDelayWithAdditionalDialogs 要素によって制御されていました。
SP1 以降の Windows Vista では、802.1X スキーマの maxDelayWithAdditionalDialogs 要素は無視され、非推奨となります。
-
bAllowLogonDialogs
-
ログオン前 SSO を使用するときに EAP ダイアログを表示するかどうかを示す 値です。 詳細については、802.1X スキーマの allowAdditionalDialogs 要素を参照してください。
-
bUserBasedVLan
-
デバイスで使用される仮想 LAN (VLAN) がユーザーの資格情報に基づいて変更されるかどうかを指定する 802.1X スキーマの userBasedVirtualLan 要素。 一部のネットワーク アクセス サーバー (NAS) デバイスでは、ユーザーの認証後に VLAN が変更されます。 userBasedVirtualLan が TRUE の場合、NAS はユーザーの認証後にデバイスの VLAN を変更する可能性があります。 詳細については、802.1X スキームの userBasedVirtualLan (singleSignOn) 要素 を参照してください。
解説
ONEX_CONNECTION_PROFILE構造は、Windows Vista 以降でサポートされている新しいワイヤレス構成コンポーネントである 802.1X モジュールで使用されます。
ONEX_RESULT_UPDATE_DATAには、802.1X 認証への状態の変更に関する情報が含まれています。 ONEX_RESULT_UPDATE_DATA構造体は、WLAN_NOTIFICATION_DATA構造体のNotificationSource メンバーがWLAN_NOTIFICATION_SOURCE_ONEXされ、受信した通知のWLAN_NOTIFICATION_DATA構造体の NotificationCode メンバーが OneXNotificationTypeResultUpdate の場合に返されます。 この通知では、WLAN_NOTIFICATION_DATA 構造体の pData メンバーは、802.1X 認証状態の変更に関する情報を含むONEX_RESULT_UPDATE_DATA構造体を指します。
ONEX_RESULT_UPDATE_DATA構造体の fOneXAuthParams メンバーが設定されている場合、ONEX_RESULT_UPDATE_DATA構造体の authParams メンバーには、ONEX_VARIABLE_BLOBの dwOffset メンバーから始まるONEX_AUTH_PARAMS構造体が埋め込まれたONEX_VARIABLE_BLOB構造体が含まれます。 ONEX_AUTH_PARAMS構造体の oneXConnProfile メンバーには、ONEX_VARIABLE_BLOBの dwOffset メンバーから始まるONEX_CONNECTION_PROFILE構造体が埋め込まれたONEX_VARIABLE_BLOB構造体が含まれています。
ONEX_CONNECTION_PROFILE構造体は、パブリック ヘッダー ファイルでは定義されていません。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows Server 2008 [デスクトップ アプリのみ] |
関連項目