WZCQueryInterface 함수
[WZCQueryInterface 는 Windows Vista 및 Windows Server 2008을 기준으로 더 이상 지원되지 않습니다. 대신 WlanQueryInterface 함수를 사용합니다. 자세한 내용은 네이티브 Wifi API 정보를 참조하세요. ]
WZCQueryInterface 함수는 무선 제로 구성 서비스에서 관리하는 무선 LAN 인터페이스에 대한 자세한 정보를 제공합니다.
지정된 인터페이스에 대한 자세한 정보를 제공합니다.
구문
DWORD WZCQueryInterface(
_In_ LPWSTR pSrvAddr,
_In_ DWORD dwInFlags,
_Inout_ PINTF_ENTRY pIntf,
_Out_ LPDWORD pdwOutFlags
);
매개 변수
-
pSrvAddr [in]
-
이 함수를 실행할 컴퓨터의 이름을 포함하는 문자열에 대한 포인터입니다. 이 매개 변수가 NULL이면 무선 제로 구성 서비스가 로컬 컴퓨터에서 쿼리됩니다.
지정된 pSrvAddr 매개 변수가 원격 컴퓨터인 경우 원격 컴퓨터는 원격 RPC 호출을 지원해야 합니다.
-
dwInFlags [in]
-
쿼리할 필드입니다. 다음 플래그의 조합을 포함할 수 있는 비트 마스크입니다.
값 의미 - INTF_DYNFLAGS
- 0x00000010
pIntf 매개 변수가 가리키는 INTF_ENTRY 구조체에서 dwDynFlags 멤버의 값을 반환합니다. - INTF_DESCR
- 0x00010000
pIntf 매개 변수가 가리키는 INTF_ENTRY 구조체에서 wszDescr 멤버의 값을 반환합니다. - INTF_NDISMEDIA
- 0x00020000
pIntf 매개 변수가 가리키는 INTF_ENTRY 구조체에서 ulMediaState, ulMediaType 및 ulPhysicalMediaType 멤버의 값을 반환합니다. - INTF_PREFLIST
- 0x00040000
pIntf 매개 변수가 가리키는 INTF_ENTRY 구조체의 rdStSSIDList 멤버에 있는 기본 네트워크 목록을 반환합니다. - INTF_CAPABILITIES
- 0x00080000
pIntf 매개 변수가 가리키는 INTF_ENTRY 구조체의 dwCapabilities 및 rdNicCapabilities 멤버에 대한 값을 반환합니다. - INTF_INFRAMODE
- 0x00200000
pIntf 매개 변수가 가리키는 INTF_ENTRY 구조체에서 nInfraMode 멤버의 값을 반환합니다.
nInfraMode 멤버는 일부 인터페이스 컨텍스트 상태에서만 유효합니다.- INTF_AUTHMODE
- 0x00400000
pIntf 매개 변수가 가리키는 INTF_ENTRY 구조체에서 nAuthMode 멤버의 값을 반환합니다.
nAuthMode 멤버는 일부 인터페이스 컨텍스트 상태에서만 유효합니다.- INTF_WEPSTATUS
- 0x00800000
pIntf 매개 변수가 가리키는 INTF_ENTRY 구조체에서 nWepStatus 멤버의 값을 반환합니다.
nWepStatus 멤버는 일부 인터페이스 컨텍스트 상태에서만 유효합니다.- INTF_SSID
- 0x01000000
pIntf 매개 변수가 가리키는 INTF_ENTRY 구조체에서 rdSSID 멤버의 값을 반환합니다.
rdSSID 멤버는 일부 인터페이스 컨텍스트 상태에서만 유효합니다.- INTF_BSSID
- 0x02000000
pIntf 매개 변수가 가리키는 INTF_ENTRY 구조체에서 rdBSSID 멤버의 값을 반환합니다.
rdBSSID 멤버는 일부 인터페이스 컨텍스트 상태에서만 유효합니다.- INTF_BSSIDLIST
- 0x04000000
pIntf 매개 변수가 가리키는 INTF_ENTRY 구조체의 rdBSSIDList 멤버에 표시되는 네트워크 목록을 반환합니다.
rdBSSIDList 멤버는 일부 인터페이스 컨텍스트 상태에서만 유효합니다. -
pIntf [in, out]
-
입력에서 쿼리할 인터페이스의 키에 대한 포인터입니다. 출력에서 요청된 인터페이스 데이터에 대한 포인터입니다. 이 매개 변수는 INTF_ENTRY 구조체에 대한 포인터입니다.
-
pdwOutFlags [out]
-
성공적으로 검색된 필드 집합입니다.
반환 값
함수가 성공하면 반환 값이 ERROR_SUCCESS.
함수가 실패하면 반환 값은 다음 반환 코드 중 하나일 수 있습니다.
| 반환 코드 | 설명 |
|---|---|
|
스토리지 제어 블록이 제거되었습니다. 무선 제로 구성 서비스가 내부 개체를 초기화하지 않은 경우 이 오류가 반환됩니다. |
|
시스템은 지정된 파일을 찾을 수 없습니다.
pIntf 매개 변수가 가리키는 INTF_ENTRY 구조체의 wszGuid 멤버의 GUID가 로컬 컴퓨터의 무선 LAN 인터페이스와 일치하지 않으면 이 오류가 반환됩니다. |
|
매개 변수가 잘못되었습니다.
pIntf 매개 변수가 NULL인 경우 이 오류가 반환됩니다. 이 오류는 pIntf 매개 변수가 가리키는 INTF_ENTRY 구조체의 wszGuid 멤버가 NULL인 경우 반환됩니다. |
|
이 요청을 처리하고 쿼리 결과에 대한 메모리를 할당하는 데 메모리가 부족합니다. |
|
다양한 오류 코드. |
설명
pIntf 매개 변수가 가리키는 INTF_ENTRY 구조체의 wszGuid 멤버에는 무선 LAN 인터페이스에 대한 인터페이스 GUID가 포함되어야 합니다. WZCEnumInterfaces 함수를 호출하여 무선 LAN 인터페이스 목록을 검색할 수 있습니다.
wZCQueryInterface 함수를 호출하기 전에 pIntf가 가리키는 INTF_ENTRY 구조체의 다음 멤버를 0으로 설정해야 합니다. rdSSID, rdBSSID, rdBSSIDList, rdStSSIDList 및 rdCtrlData.
무선 제로 구성 서비스는 미디어 연결 및 연결이 끊긴 이벤트를 수신하는 경우에도 미디어 상태를 자동으로 업데이트하지 않습니다. 애플리케이션은 NDIS 미디어 상태를 요청해야 하는 경우 WZCQueryInterface 함수를 호출하기 전에 WZCRefreshInterface 함수를 호출하여 미디어 상태를 강제로 새로 고쳐야 합니다(dwInFlags 매개 변수에서 INTF_NDISMEDIA 비트가 설정됨).
dwInFlags 매개 변수에 INTF_BSSIDLIST 포함된 경우 WZCQueryInterface 함수는 표시되는 네트워크 목록이 비어 있는 경우 INTF_BSSIDLISTdwOutFlags를 설정하지 않습니다. dwInFlags 매개 변수에 INTF_SSID 포함된 경우 WZCQueryInterface 함수는 SSID를 사용할 수 없는 경우 INTF_SSIDdwOutFlags를 설정하지 않습니다.
WZCQueryInterface 함수가 ERROR_SUCCESS 반환하는 경우 호출자는 pIntf 매개 변수를 사용하여 LocalFree 함수를 호출하여 이 정보가 더 이상 필요하지 않으면 반환된 데이터에 할당된 내부 버퍼를 해제해야 합니다. 그러면 pIntf 매개 변수가 가리키는 INTF_ENTRY 구조체의 rdSSID, rdBSSID, rdBSSIDList, rdStSSIDList 및 rdCtrlData 멤버에서 사용하는 버퍼가 해제됩니다.
참고
Wzcsapi.h 헤더 파일 및 Wzcsapi.lib 가져오기 라이브러리 파일은 Windows SDK에서 사용할 수 없습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
WINDOWS XP SP2 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 |
Windows Server 2003 [데스크톱 앱만 해당] |
| 클라이언트 지원 종료 |
Windows XP with SP3 |
| 서버 지원 종료 |
Windows Server 2003 |
| 헤더 |
|
| 라이브러리 |
|
| DLL |
|
추가 정보