ONEX_AUTH_PARAMS構造体 (dot1x.h)

[アーティクル]
08/23/2023

ONEX_AUTH_PARAMS構造には、802.1X 認証に使用される 802.1X 認証パラメーターが含まれています。

構文

typedef struct _ONEX_AUTH_PARAMS {
  BOOL               fUpdatePending;
  ONEX_VARIABLE_BLOB oneXConnProfile;
  ONEX_AUTH_IDENTITY authIdentity;
  DWORD              dwQuarantineState;
  DWORD              fSessionId : 1;
  DWORD              fhUserToken : 1;
  DWORD              fOnexUserProfile : 1;
  DWORD              fIdentity : 1;
  DWORD              fUserName : 1;
  DWORD              fDomain : 1;
  DWORD              dwSessionId;
  HANDLE             hUserToken;
  ONEX_VARIABLE_BLOB OneXUserProfile;
  ONEX_VARIABLE_BLOB Identity;
  ONEX_VARIABLE_BLOB UserName;
  ONEX_VARIABLE_BLOB Domain;
} ONEX_AUTH_PARAMS, *PONEX_AUTH_PARAMS;

メンバー

fUpdatePending

802.X 認証の状態更新が保留中かどうかを示します。

oneXConnProfile

802.1X 認証接続プロファイル。このメンバーには、 ONEX_VARIABLE_BLOB の dwOffset メンバーから始まる埋め込みONEX_CONNECTION_PROFILE構造体が含まれています。

authIdentity

802.1X 認証状態に使用される ID。このメンバーは、 ONEX_AUTH_IDENTITY 列挙体の値です。

dwQuarantineState

ローカルコンピューターの検疫分離状態の値。分離状態によって、そのネットワーク接続が決まります。このメンバーは、EAPHost ISOLATION_STATE 列挙からの値に対応します。

fSessionId

ONEX_AUTH_PARAMS構造体に dwSessionId メンバーにセッション ID が含まれているかどうかを示します。

fhUserToken

ONEX_AUTH_PARAMS構造体に hUserToken メンバーにユーザートークンハンドルが含まれているかどうかを示します。

セキュリティ上の理由から、ONEX_RESULT_UPDATE_DATA構造体の authParams メンバーで返されるONEX_AUTH_PARAMS構造体の hUserToken メンバーは常に NULL に設定されます。

fOnexUserProfile

ONEX_AUTH_PARAMS構造体に OneXUserProfile メンバーに 802.1X ユーザープロファイルが含まれているかどうかを示します。

セキュリティ上の理由から、ONEX_RESULT_UPDATE_DATA構造体の authParams メンバーで返されるONEX_AUTH_PARAMS構造体の OneXUserProfile メンバーは常に NULL に設定されます。

fIdentity

ONEX_AUTH_PARAMS構造体に ID メンバーに 802.1X ID が含まれているかどうかを示します。

fUserName

ONEX_AUTH_PARAMS構造体に、UserName メンバーの 802.1X 認証に使用されるユーザー名が含まれているかどうかを示します。

fDomain

ONEX_AUTH_PARAMS構造体に、ドメインメンバーの 802.1X 認証に使用されるドメインが含まれているかどうかを示します。

dwSessionId

現在コンソールにログオンしているユーザーのセッション ID。このメンバーは、 WTSGetActiveConsoleSessionId 関数によって返される値に対応します。 fSessionId ビットフィールドメンバーが設定されている場合、このメンバーにはセッション ID が含まれます。

hUserToken

802.1X 認証に使用されるユーザートークンハンドル。このメンバーには、 fhUserToken ビットフィールドメンバーが設定されている場合のユーザートークンハンドルが含まれます。

OneXUserProfile

802.1X 認証に使用される 802.1X ユーザープロファイル。このメンバーには、fOneXUserProfile ビットフィールドメンバーが設定されている場合、ONEX_VARIABLE_BLOBの dwOffset メンバーから始まる埋め込みユーザープロファイルが含まれます。

Identity

802.1X 認証に使用される 802.1X ID。このメンバーには、fIdentity ビットフィールドメンバーが設定されている場合、ONEX_VARIABLE_BLOBの dwOffset メンバーから始まる ID を持つ NULL で終わる Unicode 文字列が含まれます。

UserName

802.1X 認証に使用されるユーザー名。このメンバーには、fUserName ビットフィールドメンバーが設定されている場合、ONEX_VARIABLE_BLOBの dwOffset メンバーから始まるユーザー名を含む NULL で終わる Unicode 文字列が含まれます。

Domain

802.1X 認証に使用されるドメイン。このメンバーには、fDomain ビットフィールドメンバーが設定されている場合、ドメインがONEX_VARIABLE_BLOBの dwOffset メンバーから始まる NULL で終わる Unicode 文字列が含まれます。

解説

ONEX_AUTH_PARAMS構造は、Windows Vista 以降でサポートされている新しいワイヤレス構成コンポーネントである 802.1X モジュールで使用されます。

ONEX_RESULT_UPDATE_DATAには、802.1X 認証への状態変更に関する情報が含まれています。 WLAN_NOTIFICATION_DATA構造体のNotificationSource メンバーがWLAN_NOTIFICATION_SOURCE_ONEXされ、受信した通知のWLAN_NOTIFICATION_DATA構造体の NotificationCode メンバーが OneXNotificationTypeResultUpdate である場合、ONEX_RESULT_UPDATE_DATA構造体が返されます。この通知では、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構造体が含まれます。

セキュリティ上の理由から、authParams メンバーで返されるONEX_AUTH_PARAMS構造体の hUserToken メンバーと OneXUserProfile メンバーは常に NULL に設定されます。

要件


サポートされている最小のクライアント	Windows Vista [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップアプリのみ]
Header	dot1x.h

次の方法で共有

ONEX_AUTH_PARAMS構造体 (dot1x.h)

構文

メンバー

解説

要件

関連項目

フィードバック

その他のリソース