WlanHostedNetworkSetProperty 함수(wlanapi.h)

아티클
08/28/2023

WlanHostedNetworkSetProperty 함수는 무선 Hosted Network의 정적 속성을 설정합니다.

구문

DWORD WlanHostedNetworkSetProperty(
  [in]            HANDLE                      hClientHandle,
  [in]            WLAN_HOSTED_NETWORK_OPCODE  OpCode,
  [in]            DWORD                       dwDataSize,
  [in]            PVOID                       pvData,
  [out, optional] PWLAN_HOSTED_NETWORK_REASON pFailReason,
                  PVOID                       pvReserved
);

매개 변수

[in] hClientHandle

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

[in] OpCode

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

wlan_hosted_network_opcode_connection_settings

호스트된 네트워크 연결 설정입니다.

wlan_hosted_network_opcode_enable

호스트된 네트워크 사용 플래그입니다.

[in] dwDataSize

pvData 매개 변수가 가리키는 버퍼의 크기(바이트)를 지정하는 값입니다.

[in] pvData

설정할 정적 속성이 있는 버퍼에 대한 포인터입니다. 이 버퍼와 연결된 데이터 형식은 OpCode 매개 변수의 값에 따라 달라집니다.

[out, optional] pFailReason

WlanHostedNetworkSetProperty 함수에 대한 호출이 실패하는 경우 실패 이유를 수신하는 값에 대한 선택적 포인터입니다. 실패 원인에 대한 가능한 값은 Wlanapi.h 헤더 파일에 정의된 WLAN_HOSTED_NETWORK_REASON 열거형 형식에서 가져옵니다.

pvReserved

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

반환 값

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

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

반환 코드	설명
ERROR_ACCESS_DENIED	호출자에게 충분한 권한이 없습니다. OpCode 매개 변수가 wlan_hosted_network_opcode_enable 무선 Hosted Network가 도메인의 그룹 정책에 의해 비활성화된 경우에도 이 오류가 반환됩니다.
ERROR_BAD_PROFILE	무선 호스트 네트워크에서 사용하는 네트워크 연결 프로필이 손상되었습니다.
ERROR_INVALID_HANDLE	핸들이 잘못되었습니다. hClientHandle 매개 변수에 지정된 핸들이 핸들 테이블에 없는 경우 이 오류가 반환됩니다.
ERROR_INVALID_PARAMETER	매개 변수가 잘못되었습니다. 다음 조건이 발생하면 이 오류가 반환됩니다. hClientHandle 은 NULL입니다. OpCode 는 WLAN_HOSTED_NETWORK_OPCODE 정의된 열거형 값 중 하나가 아닙니다. dwDataSize 가 0입니다. pvData 는 NULL입니다. pvData 는 올바른 형식의 정적 속성을 가리키지 않습니다. pvReserved 가 NULL이 아닙니다.
ERROR_INVALID_STATE	리소스가 요청된 작업을 수행하기에 올바른 상태가 아닙니다. 무선 Hosted Network가 종료 중이면 이 문제가 발생할 수 있습니다.
ERROR_NOT_SUPPORTED	요청이 지원되지 않습니다. 이 오류는 애플리케이션이 OpCode 매개 변수가 wlan_hosted_network_opcode_station_profile 또는 wlan_hosted_network_opcode_security_settings 설정된 WlanHostedNetworkSetProperty 함수를 호출하는 경우 반환됩니다.
ERROR_SERVICE_NOT_ACTIVE	서비스가 시작되지 않았습니다. WLAN AutoConfig 서비스가 실행되고 있지 않으면 이 오류가 반환됩니다.
기타	다양한 RPC 및 기타 오류 코드. FormatMessage를 사용하여 반환된 오류에 대한 메시지 문자열을 가져옵니다.

설명

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

클라이언트 애플리케이션은 WlanHostedNetworkSetProperty 함수를 호출하여 무선 Hosted Network의 현재 정적 속성을 설정합니다. 호출하는 애플리케이션이 호출 핸들을 닫거나(hClientHandle 매개 변수를 사용하여 WlanCloseHandle을 호출하여) 프로세스가 종료되는 경우 이 함수로 인한 호스트된 네트워크 속성 변경은 자동으로 실행 취소되지 않습니다.

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

OpCode	Description
wlan_hosted_network_opcode_connection_settings	WLAN_HOSTED_NETWORK_CONNECTION_SETTINGS 구조체에 대한 포인터는 pvData 매개 변수에 전달됩니다.
wlan_hosted_network_opcode_enable	BOOL에 대한 포인터는 pvData 매개 변수에 전달됩니다.

OpCode 매개 변수를 wlan_hosted_network_opcode_enable 설정하여 WlanHostedNetworkSetProperty 함수를 호출하는 경우 사용자에게 적절한 관련 권한이 있어야 합니다. 권한은 WLAN_SECURABLE_OBJECT 연결된 DACL(임의 액세스 제어 목록)에 저장됩니다. wlan_hosted_network_opcode_enableOpCode 매개 변수를 사용하여 WlanHostedNetworkSetProperty 함수를 호출하려면 호출자의 클라이언트 액세스 토큰에 WLAN_SECURABLE_OBJECT 다음 열거형에 의해 노출되는 상승된 권한이 있어야 합니다.

wlan_secure_hosted_network_elevated_access

OpCode 매개 변수에서 WlanHostedNetworkSetProperty 함수가 다음 값 중에서 전달되면 함수는 ERROR_NOT_SUPPORTED 함께 실패합니다.

wlan_hosted_network_opcode_station_profile
wlan_hosted_network_opcode_connection_settings

성공하려면 WlanHostedNetworkSetProperty 함수는 호스트된 네트워크 상태가 현재 실행 중인 경우 wlan_hosted_network_idle 전환해야 하는 새 설정을 유지해야 합니다(wlan_hosted_network_active).

모든 사용자가 이 함수를 호출하여 호스트된 네트워크 속성을 설정할 수 있습니다. 그러나 wlan_hosted_network_opcode_enable 플래그를 설정하려면 상승된 권한이 필요합니다. 무선 호스트 네트워크를 사용하도록 설정하는 기능은 도메인의 그룹 정책에 의해 제한될 수도 있습니다.

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