WlanHostedNetworkQueryProperty 함수(wlanapi.h)

아티클
08/28/2023

WlanHostedNetworkQueryProperty 함수는 무선 Hosted Network의 현재 정적 속성을 쿼리합니다.

구문

DWORD WlanHostedNetworkQueryProperty(
  [in]  HANDLE                     hClientHandle,
  [in]  WLAN_HOSTED_NETWORK_OPCODE OpCode,
  [out] PDWORD                     pdwDataSize,
  [out] PVOID                      *ppvData,
  [out] PWLAN_OPCODE_VALUE_TYPE    pWlanOpcodeValueType,
        PVOID                      pvReserved
);

매개 변수

[in] hClientHandle

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

[in] OpCode

쿼리할 속성의 식별자입니다. 이 식별자는 Wlanapi.h 헤더 파일에 정의된 WLAN_HOSTED_NETWORK_OPCODE 열거형의 값일 수 있습니다.

[out] pdwDataSize

WlanHostedNetworkQueryProperty 함수에 대한 호출이 성공하는 경우 ppvData 매개 변수에 반환된 버퍼의 크기(바이트)를 지정하는 값에 대한 포인터입니다.

[out] ppvData

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

출력 시 이 매개 변수는 WlanHostedNetworkQueryProperty 함수에 대한 호출이 성공하면 요청된 정적 속성과 함께 반환된 버퍼에 대한 포인터를 받습니다. 이 버퍼와 연결된 데이터 형식은 OpCode 매개 변수의 값에 따라 달라집니다.

[out] pWlanOpcodeValueType

WlanHostedNetworkQueryProperty 함수에 대한 호출이 성공하는 경우 무선 Hosted Network 속성의 값 형식을 수신하는 값에 대한 포인터입니다. 반환된 값은 Wlanapi.h 헤더 파일에 정의된 WLAN_OPCODE_VALUE_TYPE 열거형의 열거형 형식입니다.

pvReserved

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

반환 값

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

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

반환 코드	설명
ERROR_BAD_CONFIGURATION	무선 호스트 네트워크에 대한 구성 데이터가 구성되지 않았습니다. 이 오류는 애플리케이션이 무선 Hosted Network에서 SSID가 구성되기 전에 OpCode 매개 변수가 wlan_hosted_network_opcode_station_profile 또는 wlan_hosted_network_opcode_connection_settings 설정된 WlanHostedNetworkQueryProperty 함수를 호출하는 경우 반환됩니다.
ERROR_INVALID_HANDLE	핸들이 잘못되었습니다. hClientHandle 매개 변수에 지정된 핸들이 핸들 테이블에 없는 경우 이 오류가 반환됩니다.
ERROR_INVALID_PARAMETER	매개 변수가 잘못되었습니다. 다음 조건이 발생하면 이 오류가 반환됩니다. hClientHandle 은 NULL입니다. OpCode 는 WLAN_HOSTED_NETWORK_OPCODE 정의된 열거형 값 중 하나가 아닙니다. pdwDataSize 가 NULL입니다. ppvData 는 NULL입니다. pWlanOpcodeValueType 은 NULL입니다. pvReserved 가 NULL이 아닙니다.
ERROR_INVALID_STATE	리소스가 요청된 작업을 수행하기에 올바른 상태가 아닙니다. 무선 Hosted Network가 종료 중이면 이 문제가 발생할 수 있습니다.
ERROR_OUTOFMEMORY	스토리지가 부족하여 이 작업을 완료할 수 없습니다.
ERROR_SERVICE_NOT_ACTIVE	서비스가 시작되지 않았습니다. WLAN AutoConfig 서비스가 실행되고 있지 않으면 이 오류가 반환됩니다.
기타	다양한 RPC 및 기타 오류 코드. FormatMessage를 사용하여 반환된 오류에 대한 메시지 문자열을 가져옵니다.

설명

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

클라이언트 애플리케이션은 WlanHostedNetworkQueryProperty 함수를 호출하여 무선 Hosted Network의 현재 정적 속성을 쿼리합니다. 이 함수는 무선 Hosted Network의 상태 또는 속성을 변경하지 않습니다.

함수가 성공하면 ppvData 매개 변수는 요청된 속성이 포함된 버퍼를 가리킵니다. 이 버퍼의 크기는 pwdDataSize 매개 변수에 반환된 포인터에 반환됩니다. WLAN_OPCODE_VALUE_TYPEpWlanOpcodeValueType 매개 변수에 반환된 포인터에 반환됩니다. 반환되는 ppvData 매개 변수의 버퍼에 사용되는 메모리는 버퍼가 더 이상 필요하지 않은 후 WlanFreeMemory 함수를 호출하여 해제해야 합니다.

ppvData 매개 변수가 가리키는 버퍼와 연결된 데이터 형식은 다음과 같이 OpCode 매개 변수의 값에 따라 달라집니다.

OpCode	Description
wlan_hosted_network_opcode_connection_settings	WLAN_HOSTED_NETWORK_CONNECTION_SETTINGS 구조체에 대한 포인터가 반환됩니다.
wlan_hosted_network_opcode_security_settings	WLAN_HOSTED_NETWORK_SECURITY_SETTINGS 구조체에 대한 포인터가 반환됩니다.
wlan_hosted_network_opcode_station_profile	무선 Hosted Network에 연결하기 위한 XML WLAN 프로필을 포함하는 PWSTR 이 반환됩니다.
wlan_hosted_network_opcode_enable	무선 호스트 네트워크를 사용할 수 있는지를 나타내는 PBOOL 이 반환됩니다.

무선 Hosted Network에서 SSID를 구성하기 전에 OpCode 매개 변수에서 WlanHostedNetworkQueryProperty 함수가 다음 값 중에서 전달되면 함수는 ERROR_BAD_CONFIGURATION 함께 실패합니다.

wlan_hosted_network_opcode_station_profile
wlan_hosted_network_opcode_connection_settings

모든 사용자는 WlanHostedNetworkQueryProperty 함수를 호출하여 호스트된 네트워크 속성을 쿼리할 수 있습니다.

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