INTF_ENTRY 結構

發行項
01/10/2024

從 Windows Vista 和 Windows Server 2008 起，不再支援 [INTF_ENTRY 。請改用 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

介面 GUID 的指標，以下列格式表示為 Unicode 字串：“{xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}”。

wszDescr

字串的指標，其中包含無線零設定服務（WZCSVC）所擷取的介面描述。

dwContext

保留為內部使用。

ulMediaState

介面目前的 NDIS 媒體連線狀態。下列表格顯示可能的值。

值	意義
MEDIA_STATE_CONNECTED 1	媒體已連線。
MEDIA_STATE_DISCONNECTED 0	媒體已中斷連線。
MEDIA_STATE_UNKNOWN -1	媒體狀態未知。

ulMediaType

NIC 目前使用的 NDIS 媒體類型。查詢時，此成員的值NdisMedium802_3，如 Ndispnp.h 頭檔中所定義。

ulPhysicalMediaType

介面的 NDIS 媒體類型。查詢時，此成員的值是 NdisPhysicalMediumWirelessLan，如 Ndispnp.h 頭檔中所定義。

nInfraMode

介面上設定的目前802.11基礎結構模式。

nAuthMode

介面上設定的目前 802.11 驗證模式。

下表根據 NtDDNdis.h 頭檔中定義的NDIS_802_11_AUTHENTICATION_MODE列舉，顯示參數的可能值。

值	意義
Ndis802_11AuthModeOpen 1	IEEE 802.11 開啟系統驗證。
Ndis802_11AuthModeShared 2	IEEE 802.11 共用驗證，會使用預先共用的有線對等隱私權（WEP）密鑰。
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	網路篩選模式的位掩碼。 INTFCTL_CM_MASK和 dwCtlFlags 會產生類型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	指出簡單安全網路（SSN）的支援，其子集為 802.11i。 SSN 會定期變更加密密鑰，而不是使用靜態密鑰的 WEP（有線對等隱私權）標準。為了讓 SSN 能夠運作，支援的加密上限至少應該是 TKIP。 SSN 是由廠商聯盟在 2002 年開發，作為改善無線 LAN 安全性的臨時方法，而 IEEE 802.11i 標準正在完成。
INTFCAP_80211I 0x00000200	表示 IEEE 802.11i 標準的支援。

rdNicCapabilities

802.11i 的一組功能。

WZCQueryInterface 函式會在呼叫時傳回 rdNicCapabilities 數據，並傳回 dwInflags 參數中傳遞INTF_CAPABILITIES旗標。如果函式呼叫成功，RAW_DATA 結構的 pData 成員會包含INTF_80211_CAPABILITY結構。

rdSSID

包含介面上目前設定之 802.11 SSID 的二進位數據。

WZCQueryInterface 函式會在呼叫時傳回 rdSSID 數據，並傳回 dwInflags 參數中傳遞INTF_SSID旗標。如果函式呼叫成功，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 函式會在呼叫時傳回 rdBSSID 數據，並傳回 dwInflags 參數中傳遞INTF_BSSID旗標。如果函式呼叫成功，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 上次擷取的 BSSID 清單。

WZCQueryInterface 函式會在呼叫時傳回 rdBSSIDList 數據，並傳回 dwInflags 參數中傳遞INTF_BSSIDLIST旗標。如果函式呼叫成功，RAW_DATA 結構的 dwDataLen 成員會包含具有傳回數據的緩衝區長度，而 RAW_DATA 結構的 pData 成員包含WZC_802_11_CONFIG_LIST結構。

rdStSSIDList

二進位數據，其中包含為此介面設定的慣用網路清單。

當呼叫時，WZCQueryInterface 函式會傳回 rdStSSIDList 數據，並在 dwInflags 參數中傳遞INTF_PREFLIST旗標。如果函式呼叫成功，RAW_DATA 結構的 dwDataLen 成員會包含具有傳回數據的緩衝區長度，而 RAW_DATA 結構的 pData 成員包含WZC_802_11_CONFIG_LIST結構。

如果其中一個慣用網路目前已連線，網路WZC_WLAN_CONFIG結構的 dwCtlFlags 成員將會設定WZCCTL_MEDIA_CONNECTED （0x0400）位。

rdCtrlData

在介面上設定其他參數時，搭配其他控件旗標使用的二進位數據。

備註

WZCQueryInterface 和 WZCRefreshInterface 函式會使用INTF_ENTRY結構。

RAW_DATA 結構的定義如下：

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

pData 成員會指向二進位數據。 dwDataLen 表示 pData 所指向的位元元組數目。

注意

Windows SDK 中無法使用 Wzcsapi.h 頭檔。

需求

需求	值
最低支援的用戶端	Windows XP with SP2 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
用戶端支持結束	Windows XP with SP3
伺服器終止支援	Windows Server 2003
頁首	Wzcsapi.h

另請參閱

WZCEnumInterfaces
WZCQueryInterface
WZCRefreshInterface

共用方式為

INTF_ENTRY 結構

語法

成員

備註

需求

另請參閱

意見反應

其他資源