WlanHostedNetworkQueryStatus 함수(wlanapi.h)

아티클
08/28/2023

WlanHostedNetworkQueryStatus 함수는 무선 호스트 네트워크의 현재 상태 쿼리합니다.

구문

DWORD WlanHostedNetworkQueryStatus(
  [in]  HANDLE                      hClientHandle,
  [out] PWLAN_HOSTED_NETWORK_STATUS *ppWlanHostedNetworkStatus,
        PVOID                       pvReserved
);

매개 변수

[in] hClientHandle

WlanOpenHandle 함수에 대한 이전 호출에서 반환된 클라이언트의 세션 핸들입니다.

[out] ppWlanHostedNetworkStatus

입력에서 이 매개 변수는 NULL이어야 합니다.

출력 시 이 매개 변수는 WlanHostedNetworkQueryStatus 함수에 대한 호출이 성공하면 무선 호스트 네트워크의 현재 상태 대한 포인터를 받습니다. 현재 상태 WLAN_HOSTED_NETWORK_STATUS 구조체에 반환됩니다.

pvReserved

다음에 사용하도록 예약됩니다. 이 매개 변수는 NULL이어야 합니다.

반환 값

함수가 성공하면 반환 값이 ERROR_SUCCESS.

함수가 실패하면 반환 값은 다음 반환 코드 중 하나일 수 있습니다.

반환 코드	설명
ERROR_INVALID_HANDLE	핸들이 잘못되었습니다. hClientHandle 매개 변수에 지정된 핸들이 핸들 테이블에 없는 경우 이 오류가 반환됩니다.
ERROR_INVALID_PARAMETER	매개 변수가 잘못되었습니다. 다음 조건이 발생하면 이 오류가 반환됩니다. hClientHandle 은 NULL입니다. ppWlanHostedNetworkStatus는 NULL입니다. pvReserved 가 NULL이 아닙니다.
ERROR_INVALID_STATE	리소스가 요청된 작업을 수행하기에 올바른 상태가 아닙니다. 무선 Hosted Network가 종료 중이면 이 문제가 발생할 수 있습니다.
ERROR_SERVICE_NOT_ACTIVE	서비스가 시작되지 않았습니다. WLAN AutoConfig 서비스가 실행되고 있지 않으면 이 오류가 반환됩니다.
기타	다양한 RPC 및 기타 오류 코드. FormatMessage를 사용하여 반환된 오류에 대한 메시지 문자열을 가져옵니다.

설명

WlanHostedNetworkQueryStatus 함수는 무선 LAN 서비스가 설치된 Windows 7 및 Windows Server 2008 R2에서 무선 호스트 네트워크를 지원하기 위해 추가된 네이티브 무선 API에 대한 확장입니다.

클라이언트 애플리케이션은 WlanHostedNetworkQueryStatus 함수를 호출하여 무선 호스트 네트워크의 현재 상태 쿼리합니다. 이 함수는 무선 Hosted Network의 상태를 변경하지 않습니다.

함수가 성공하면 ppWlanHostedNetworkStatus 매개 변수는 현재 상태 있는 WLAN_HOSTED_NETWORK_STATUS 구조를 가리킵니다. 반환되는 WLAN_HOSTED_NETWORK_STATUS 구조체에 사용되는 메모리는 WlanFreeMemory 함수를 호출하여 사용 후 해제되어야 합니다.

모든 사용자는 WlanHostedNetworkQueryStatus 함수를 호출하여 호스트된 네트워크를 쿼리할 수 있습니다. 그러나 무선 호스트 네트워크를 사용하도록 설정하는 기능은 도메인의 그룹 정책에 의해 제한될 수 있습니다.

Windows 7 이상에서 운영 체제는 호스트된 네트워크 지원 무선 어댑터가 컴퓨터에 있는 경우 가상 디바이스를 설치합니다. 이 가상 디바이스는 일반적으로 컴퓨터에 단일 무선 네트워크 어댑터가 있는 경우 디바이스 이름이 'Microsoft Virtual WiFi Miniport 어댑터'인 '무선 네트워크 연결 2'로 "네트워크 Connections 폴더"에 표시됩니다. 이 가상 디바이스는 SoftAP(소프트웨어 액세스 지점) 연결을 수행하는 데만 사용되며 WlanEnumInterfaces 함수에서 반환하는 목록에는 없습니다. 이 가상 디바이스의 수명은 실제 무선 어댑터에 연결됩니다. 실제 무선 어댑터를 사용하지 않도록 설정하면 이 가상 디바이스도 제거됩니다. 이 기능은 무선 LAN 서비스가 설치된 Windows Server 2008 R2에서도 사용할 수 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 R2 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	wlanapi.h(Wlanapi.h 포함)
라이브러리	Wlanapi.lib
DLL	Wlanapi.dll