次の方法で共有

INTF_ENTRY構造

  • [アーティクル]

[INTF_ENTRY は、Windows Vista および Windows Server 2008 以降ではサポートされていません。 代わりに、同様の機能を提供する Native Wifi API を使用してください。 詳細については、「 ネイティブ Wifi API について」を参照してください。

RPC クライアントに必要なインターフェイスに関する詳細情報が含まれます。

構文

typedef struct {
  LPWSTR   wszGuid;
  LPWSTR   wszDescr;
  DWORD    dwContext;
  ULONG    ulMediaState;
  ULONG    ulMediaType;
  ULONG    ulPhysicalMediaType;
  INT      nInfraMode;
  INT      nAuthMode;
  INT      nWepStatus;
  DWORD    dwCtlFlags;
  DWORD    dwDynFlags;
  DWORD    dwCapabilities;
  RAW_DATA rdNicCapabilities;
  RAW_DATA rdSSID;
  RAW_DATA rdBSSID;
  RAW_DATA rdBSSIDList;
  RAW_DATA rdStSSIDList;
  RAW_DATA rdCtrlData;
} INTF_ENTRY, *PINTF_ENTRY;

メンバー

wszGuid

"{xxxxxxxx-xxxx-xxxx-xxxxxxxxxxxx}" の形式で Unicode 文字列として表されるインターフェイス GUID へのポインター。

wszDescr

ワイヤレス ゼロ構成サービス (WZCSVC) によって取得されるインターフェイスの説明を含む文字列へのポインター。

dwContext

内部使用のために予約されています。

ulMediaState

インターフェイスの現在の NDIS メディア接続状態。 次の表に、それぞれの値を示します。

[値] 説明
MEDIA_STATE_CONNECTED
1
 メディアが接続されています。
MEDIA_STATE_DISCONNECTED
0
 メディアが切断されています。
MEDIA_STATE_UNKNOWN
-1
 メディアの状態が不明です。

 

ulMediaType

NIC で現在使用されている NDIS メディアの種類。 クエリを実行すると、このメンバーの値は Ndispnp.h ヘッダー ファイルで定義されているようにNdisMedium802_3されます。

ulPhysicalMediaType

インターフェイスの NDIS メディアの種類。 クエリを実行すると、このメンバーの値は Ndispnp.h ヘッダー ファイルで定義されている NdisPhysicalMediumWirelessLan になります。

nInfraMode

インターフェイスに設定されている現在の 802.11 インフラストラクチャ モード。

nAuthMode

インターフェイスに設定されている現在の 802.11 認証モード。

次の表は、NtDDNdis.h ヘッダー ファイルで定義されているNDIS_802_11_AUTHENTICATION_MODE列挙に基づいてパラメーターに指定できる値を示しています。

値 説明
Ndis802_11AuthModeOpen
1
 IEEE 802.11 Open System 認証。
Ndis802_11AuthModeShared
2
 事前共有有線プライバシー (WEP) キーを使用する IEEE 802.11 共有認証。
Ndis802_11AuthModeAutoSwitch
3
 自動切り替えモード。 自動切り替えモードを使用する場合、ワイヤレス ネットワーク インターフェイス カード (NIC) は最初に共有認証モードを試行します。 共有モードが失敗した場合、NIC はオープン認証モードの使用を試みます。
Ndis802_11AuthModeWPA
4
 ワイヤレス保護アクセス (WPA) のセキュリティ。 認証は、IEEE 802.1X 経由でサプリカント、認証サーバー、および認証サーバーの間で実行されます。 暗号化キーは動的であり、認証プロセスを通じて派生します。
Ndis802_11AuthModeWPAPSK
5
 事前共有キーを使用した WPA セキュリティ。 認証は、IEEE 802.1X を介してサプリカントと認証子の間で実行されます。 暗号化キーは動的であり、サプリカントと認証子によって使用される事前共有キーを介して派生されます。
Ndis802_11AuthModeWPANone
6
 WPA セキュリティ。 認証は、IEEE 802.1X 認証なしで事前共有キーを使用して実行されます。 暗号化キーは静的であり、事前共有キーを介して派生します。 このモードは、アドホック ネットワークの種類にのみ適用されます。
Ndis802_11AuthModeWPA2
7
 WPA2 セキュリティ。 認証は、IEEE 802.1X 経由でサプリカント、認証サーバー、および認証サーバーの間で実行されます。 暗号化キーは動的であり、認証プロセスを通じて派生します。
Ndis802_11AuthModeWPA2PSK
8
 WPA2 セキュリティを指定します。 認証は、IEEE 802 1X 経由でサプリカントと認証子の間で実行されます。 暗号化キーは動的であり、サプリカントと認証子によって使用される事前共有キーを介して派生されます。
Ndis802_11AuthModeMax
9
 NDIS_802_11_AUTHENTICATION_MODE列挙値に指定できる最大値。 これは認証モードの有効な値ではありません。

 

nWepStatus

インターフェイスに設定されている現在の 802.11 暗号化モード。

dwCtlFlags

インターフェイスで WZCSVC がどのように動作しているかを示すコントロール フラグのビットマスク値。

次の表に、使用可能なビット値を示します。

値 説明
INTFCTL_CM_MASK
0x0007
 ネットワーク フィルター モードのビットマスク。 dwCtlFlags をINTFCTL_CM_MASK & すると、NDIS_802_11_NETWORK_INFRASTRUCTURE型の値になります。 結果の値は、WZCSVC がインフラストラクチャ ネットワーク、アドホック ネットワーク、または両方の種類のネットワークにのみ接続するかどうかを示します。
INTFCTL_ENABLED
0x8000
 WZCSVC でインターフェイスを構成する必要があるかどうかを示します。
INTFCTL_FALLBACK
0x4000
 優先ネットワークが使用できない場合、この値は、WZCSVC が使用可能なネットワークに関連付ける NIC を自動的に構成する必要があるかどうかを示します。
INTFCTL_OIDSSUPP
0x2000
 NIC ドライバーが WZCSVC で機能するために必要なすべての 802.11 OID をサポートするかどうかを示します。
INTFCTL_VOLATILE
0x1000
 このインターフェイスのサービス パラメーターをレジストリに保持するかどうかを示します。
この値が設定されている場合、これらのパラメーターは揮発性であり、レジストリに保持しないでください。
INTFCTL_POLICY
0x0800
 このインターフェイスのサービス パラメーターがグループ ポリシーによってプッシュされるかどうかを示します。
この値が設定されている場合、サービス パラメーターはグループ ポリシーによってローカル コンピューターにプッシュされます。
INTFCTL_8021XSUPP
0x1000
 802.1X サポートが有効かどうかを示します。

 

dwDynFlags

インターフェイスの動的 (非永続的および非静的) 動作を制御する動的フラグのビットマスク。

これらのビットは、WZCSVC がインターフェイスで動作する方法で動的な一時的な変更をトリガーするのに役立ちます。 これらのビットはいずれもレジストリに保持されないため、設定はシステムの再起動やデバイスの無効化と有効化シーケンスに耐えられません。

次の表に、使用可能なビット値を示します。

値 説明
INTFDYN_NOSCAN
0x00000001
 WZCSVC は、インターフェイスがアクティブ スキャンを実行することを要求せず、代わりに NIC ドライバーでキャッシュされた値を使用することを示します。

 

dwCapabilities

ドライバーの機能を指定します。

値 説明
INTFCAP_MAX_CIPHER_MASK
0x000000ff
 このメンバーの下位ビットは、サポートされている最大暗号化を示すために使用されます。 指定できる値は、Windows SDK に含まれる NtDDNdis.h ヘッダー ファイルのNDIS_802_11_WEP_STATUS構造体で定義されている列挙値の一部です。
Ndis802_11Encryption1Enabled値 (2) は、WEP がサポートされていることを示します。 TKIP と AES はサポートされておらず、送信キーが使用できる場合と使用できない場合があります。
Ndis802_11Encryption2Enabled値 (9) は、TKIP と WEP がサポートされていることを示します。 AES はサポートされておらず、送信キーを使用できます。
Ndis802_11Encryption3Enabled値 (11) は、AES、TKIP、WEP がサポートされており、送信キーが使用可能であることを示します。
Ndis802_11EncryptionNotSupported (8) は、WEP キーがサポートされていないことを示します。
INTFCAP_SSN
0x00000100
 802.11i のサブセットである Simple Secure Network (SSN) のサポートを示します。
SSN は、静的キーを使用する WEP (有線同等のプライバシー) 標準とは対照的に、暗号化キーを定期的に変更します。 SSN を機能させるには、サポートされる暗号の最大数が少なくとも TKIP である必要があります。 SSNは、IEEE 802.11i標準が完成している間に無線LANセキュリティを改善するための暫定的なアプローチとして、2002年にベンダーのコンソーシアムによって開発されました。
INTFCAP_80211I
0x00000200
 IEEE 802.11i 標準のサポートを示します。

 

rdNicCapabilities

802.11i の一連の機能。

WZCQueryInterface 関数は、dwInflags パラメーターで渡されたINTF_CAPABILITIES フラグを使用して呼び出されると、rdNicCapabilities データを返します。 関数呼び出しが成功した場合、RAW_DATA構造体の pData メンバーには、INTF_80211_CAPABILITY構造体が含まれます。

rdSSID

インターフェイスで現在設定されている 802.11 SSID を含むバイナリ データ。

WZCQueryInterface 関数は、dwInflags パラメーターで渡されたINTF_SSID フラグを使用して呼び出されると、rdSSID データを返します。 関数呼び出しが成功した場合、RAW_DATA構造体の dwDataLen メンバーにはNDIS_802_11_SSID構造体の SsidLength メンバーが含まれており、RAW_DATA構造体の pData メンバーには、NDIS_802_11_SSID構造体の Ssid メンバーが含まれます。

NDIS_802_11_SSID構造体は、Ntddndis.h ヘッダー ファイルで定義されます。

rdBSSID

インターフェイスで構成された 802.11 BSSID を含むバイナリ データ。

WZCQueryInterface 関数は、dwInflags パラメーターで渡されたINTF_BSSID フラグを使用して呼び出されると、rdBSSID データを返します。 関数呼び出しが成功した場合、RAW_DATA構造体の dwDataLen メンバーにはNDIS_802_11_MAC_ADDRESS構造体のサイズが含まれており、RAW_DATA構造体の pData メンバーには NDIS_802_11_MAC_ADDRESS 構造体が含まれます。

NDIS_802_11_MAC_ADDRESS構造体は、Ntddndis.h ヘッダー ファイルで定義されます。

rdBSSIDList

WZCSVC によって最後に取得された BSS ID のリストを含むバイナリ データ。

WZCQueryInterface 関数は、dwInflags パラメーターで渡されたINTF_BSSIDLIST フラグを使用して呼び出されると、rdBSSIDList データを返します。 関数呼び出しが成功した場合、RAW_DATA構造体の dwDataLen メンバーには、返されたデータを含むバッファーの長さが含まれており、RAW_DATA構造体の pData メンバーには WZC_802_11_CONFIG_LIST 構造体が含まれます。

rdStSSIDList

このインターフェイス用に構成された優先ネットワークの一覧を含むバイナリ データ。

WZCQueryInterface 関数は、dwInflags パラメーターで渡されたINTF_PREFLIST フラグを使用して呼び出されると、rdStSSIDList データを返します。 関数呼び出しが成功した場合、RAW_DATA構造体の dwDataLen メンバーには、返されたデータを含むバッファーの長さが含まれており、RAW_DATA構造体の pData メンバーには WZC_802_11_CONFIG_LIST 構造体が含まれます。

優先ネットワークのいずれかが現在接続されている場合、ネットワークのWZC_WLAN_CONFIG構造体の dwCtlFlags メンバーには、WZCCTL_MEDIA_CONNECTED (0x0400) ビットが設定されます。

rdCtrlData

インターフェイスに追加のパラメーターを設定するときに、他のコントロール フラグと共に使用されるバイナリ データ。

解説

INTF_ENTRY構造体は、WZCQueryInterface 関数と WZCRefreshInterface 関数によって使用されます。

RAW_DATA構造体は次のように定義されます。

typedef struct
{
    DWORD   dwDataLen;
    LPBYTE  pData;
} RAW_DATA, *PRAW_DATA;

pData メンバーはバイナリ データを指します。 dwDataLen は、pData が指すバイト数を示します。

Note

Wzcsapi.h ヘッダー ファイルは、Windows SDK では使用できません。

 

要件

要件 値
サポートされている最小のクライアント
 WINDOWS XP と SP2 [デスクトップ アプリのみ]
サポートされている最小のサーバー
 Windows Server 2003 [デスクトップ アプリのみ]
クライアント サポートの終了
 Windows XP と SP3
サーバー サポートの終了
 Windows Server 2003
ヘッダー
Wzcsapi.h

関連項目

WZCEnumInterfaces

WZCQueryInterface

WZCRefreshInterface