다음을 통해 공유

INTF_ENTRY 구조체

  • 아티클

[INTF_ENTRY Windows Vista 및 Windows Server 2008을 기준으로 더 이상 지원되지 않습니다. 대신 유사한 기능을 제공하는 네이 티브 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}" 형식으로 유니코드 문자열로 표현되는 인터페이스 GUID에 대한 포인터입니다.

wszDescr

WZCSVC(Wireless Zero Configuration Service)에서 검색되는 인터페이스 설명이 포함된 문자열에 대한 포인터입니다.

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 시스템 인증 열기
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
 네트워크 필터 모드에 대한 비트 마스크입니다. 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
 802.11i의 하위 집합인 SSN(Simple Secure Network)에 대한 지원을 나타냅니다.
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에서 마지막으로 검색한 BSSID 목록을 포함하는 이진 데이터입니다.

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가 가리키는 바이트 수를 나타냅니다.

참고 항목

Wzcsapi.h 헤더 파일은 Windows SDK에서 사용할 수 없습니다.

 

요구 사항

요구 사항 값
지원되는 최소 클라이언트
 WINDOWS XP SP2 [데스크톱 앱만 해당]
지원되는 최소 서버
 Windows Server 2003[데스크톱 앱만 해당]
클라이언트 지원 종료
 Windows XP with SP3
서버 지원 종료
 Windows Server 2003
헤더
Wzcsapi.h

참고 항목

WZCEnumInterfaces

WZCQueryInterface

WZCRefreshInterface