WLAN_HOSTED_NETWORK_REASON 열거형(wlanapi.h)

아티클
08/28/2023

WLAN_HOSTED_NETWORK_REASON 열거형 형식은 무선 Hosted Network 함수 호출 결과에 대한 가능한 값을 지정합니다.

Syntax

typedef enum _WLAN_HOSTED_NETWORK_REASON {
  wlan_hosted_network_reason_success = 0,
  wlan_hosted_network_reason_unspecified,
  wlan_hosted_network_reason_bad_parameters,
  wlan_hosted_network_reason_service_shutting_down,
  wlan_hosted_network_reason_insufficient_resources,
  wlan_hosted_network_reason_elevation_required,
  wlan_hosted_network_reason_read_only,
  wlan_hosted_network_reason_persistence_failed,
  wlan_hosted_network_reason_crypt_error,
  wlan_hosted_network_reason_impersonation,
  wlan_hosted_network_reason_stop_before_start,
  wlan_hosted_network_reason_interface_available,
  wlan_hosted_network_reason_interface_unavailable,
  wlan_hosted_network_reason_miniport_stopped,
  wlan_hosted_network_reason_miniport_started,
  wlan_hosted_network_reason_incompatible_connection_started,
  wlan_hosted_network_reason_incompatible_connection_stopped,
  wlan_hosted_network_reason_user_action,
  wlan_hosted_network_reason_client_abort,
  wlan_hosted_network_reason_ap_start_failed,
  wlan_hosted_network_reason_peer_arrived,
  wlan_hosted_network_reason_peer_departed,
  wlan_hosted_network_reason_peer_timeout,
  wlan_hosted_network_reason_gp_denied,
  wlan_hosted_network_reason_service_unavailable,
  wlan_hosted_network_reason_device_change,
  wlan_hosted_network_reason_properties_change,
  wlan_hosted_network_reason_virtual_station_blocking_use,
  wlan_hosted_network_reason_service_available_on_virtual_station
} WLAN_HOSTED_NETWORK_REASON, *PWLAN_HOSTED_NETWORK_REASON;

상수


`wlan_hosted_network_reason_success` 값: 0 작업이 완료되었습니다.
`wlan_hosted_network_reason_unspecified` 알 수 없는 오류입니다.
`wlan_hosted_network_reason_bad_parameters` 잘못된 매개 변수입니다. 예를 들어 애플리케이션이 올바른 핸들( WlanOpenHandle 함수에서 반환된 핸들)에서 클라이언트 컨텍스트를 참조하지 못한 경우 이러한 이유 코드가 반환됩니다.
`wlan_hosted_network_reason_service_shutting_down` 서비스가 종료되고 있습니다.
`wlan_hosted_network_reason_insufficient_resources` 서비스가 리소스가 부족합니다.
`wlan_hosted_network_reason_elevation_required` 이 작업을 수행하려면 권한 상승이 필요합니다.
`wlan_hosted_network_reason_read_only` 읽기 전용 데이터를 작성하려고 했습니다.
`wlan_hosted_network_reason_persistence_failed` 데이터 지속성이 실패했습니다.
`wlan_hosted_network_reason_crypt_error` 암호화 오류가 발생했습니다.
`wlan_hosted_network_reason_impersonation` 사용자 가장에 실패했습니다.
`wlan_hosted_network_reason_stop_before_start` 잘못된 함수 호출 시퀀스가 생성되었습니다.
`wlan_hosted_network_reason_interface_available` 무선 인터페이스를 사용할 수 있게 되었습니다.
`wlan_hosted_network_reason_interface_unavailable` 무선 인터페이스를 사용할 수 없게 되었습니다. 이러한 이유로 무선 호스티드 네트워크의 네트워크 상태가 wlan_hosted_network_unavailable 때마다 무선 호스팅 네트워크 함수에서 코드를 반환합니다. 예를 들어 도메인의 그룹 정책에 의해 무선 호스팅 네트워크를 사용하지 않도록 설정한 경우 무선 호스트 네트워크의 네트워크 상태가 wlan_hosted_network_unavailable. 이 경우 WlanHostedNetworkStartUsing 또는 WlanHostedNetworkForceStart 함수에 대한 호출은 이러한 이유 코드를 반환합니다.
`wlan_hosted_network_reason_miniport_stopped` 무선 미니포트 드라이버가 호스티드 네트워크를 중지했습니다.
`wlan_hosted_network_reason_miniport_started` 무선 미니포트 드라이버 상태 변경되었습니다.
`wlan_hosted_network_reason_incompatible_connection_started` 호환되지 않는 연결이 시작되었습니다. 호환되지 않는 연결은 다음 사례 중 하나를 참조합니다. 임시 무선 연결은 기본 스테이션 어댑터에서 시작됩니다. 네트워크 모니터링은 OpCode 매개 변수가 wlan_intf_opcode_current_operation_mode 설정되고 pData 매개 변수가 DOT11_OPERATION_MODE_NETWORK_MONITOR 포함된 ULONG을 가리키는 WlanSetInterface 함수를 호출하는 애플리케이션(예: 네트워크 모니터)에 의해 기본 스테이션 어댑터에서 시작됩니다. 무선 연결은 기본 스테이션 어댑터에서 FIPS 안전 모드로 시작됩니다. FIPS 안전 모드는 무선 연결의 프로필에 지정됩니다. 자세한 내용은 FIPSMode 요소를 참조하세요. Windows는 주 스테이션 어댑터에서 호환되지 않는 연결이 시작되면 소프트웨어 기반 AP(무선 액세스 지점) 어댑터에서 무선 호스트 네트워크를 중지합니다. 무선 호스트 네트워크 상태의 네트워크 상태가 wlan_hosted_network_unavailable 됩니다.
`wlan_hosted_network_reason_incompatible_connection_stopped` 호환되지 않는 연결이 중지되었습니다. 이전에 주 스테이션 어댑터(wlan_hosted_network_reason_incompatible_connection_started)에서 호환되지 않는 연결이 시작되었지만 호환되지 않는 연결이 중지되었습니다. 호환되지 않는 연결이 시작된 결과로 무선 호스팅 네트워크가 이전에 중지된 경우 Windows는 무선 호스트 네트워크를 자동으로 다시 시작하지 않습니다. 애플리케이션은 WlanHostedNetworkStartUsing 또는 WlanHostedNetworkForceStart 함수를 호출 하여 AP 어댑터에서 무선 호스트 네트워크를 다시 시작할 수 있습니다.
`wlan_hosted_network_reason_user_action` 명시적 사용자 작업으로 인해 발생한 상태 변경이 발생했습니다.
`wlan_hosted_network_reason_client_abort` 클라이언트 중단으로 인해 발생한 상태 변경이 발생했습니다.
`wlan_hosted_network_reason_ap_start_failed` 무선 호스트 네트워크에 대한 드라이버가 시작되지 않았습니다.
`wlan_hosted_network_reason_peer_arrived` 무선 호스트 네트워크에 연결된 피어입니다.
`wlan_hosted_network_reason_peer_departed` 무선 호스트 네트워크에서 연결이 끊긴 피어입니다.
`wlan_hosted_network_reason_peer_timeout` 피어 시간이 초과되었습니다.
`wlan_hosted_network_reason_gp_denied` 그룹 정책에 의해 작업이 거부되었습니다.
`wlan_hosted_network_reason_service_unavailable` 무선 LAN 서비스가 실행되고 있지 않습니다.
`wlan_hosted_network_reason_device_change` 무선 호스트 네트워크에서 사용하는 무선 어댑터가 변경되었습니다.
`wlan_hosted_network_reason_properties_change` 무선 호스트 네트워크의 속성이 변경되었습니다.
`wlan_hosted_network_reason_virtual_station_blocking_use` 가상 스테이션이 활성 상태이며 차단 작업입니다.
`wlan_hosted_network_reason_service_available_on_virtual_station` 가상 스테이션에서 동일한 서비스를 사용할 수 있습니다.

설명

WLAN_HOSTED_NETWORK_REASON 열거형 형식은 Windows 7 이상에서 무선 호스트 네트워크를 지원하기 위해 추가된 네이티브 무선 API에 대한 확장입니다.

이 WLAN_HOSTED_NETWORK_REASON 무선 호스트 네트워크 함수 호출이 실패한 가능한 이유 또는 특정 무선 호스트 네트워크 알림이 생성된 이유를 열거합니다.

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

요구 사항


지원되는 최소 클라이언트	Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 R2 [데스크톱 앱만 해당]
머리글	wlanapi.h(Wlanapi.h 포함)