다음을 통해 공유

WlanConnect 함수(wlanapi.h)

  • 아티클

WlanConnect 함수는 특정 네트워크에 연결을 시도합니다.

구문

DWORD WlanConnect(
  [in] HANDLE                            hClientHandle,
  [in] const GUID                        *pInterfaceGuid,
  [in] const PWLAN_CONNECTION_PARAMETERS pConnectionParameters,
       PVOID                             pReserved
);

매개 변수

[in] hClientHandle

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

[in] pInterfaceGuid

연결에 사용할 인터페이스의 GUID입니다.

[in] pConnectionParameters

연결 유형, 모드, 네트워크 프로필, 네트워크를 식별하는 SSID 및 기타 매개 변수를 지정하는 WLAN_CONNECTION_PARAMETERS 구조체 에 대한 포인터입니다.

WINDOWS XP SP3 및 Windows XP용 무선 LAN API SP2 사용: WLAN_CONNECTION_PARAMETERS 멤버에는 몇 가지 제약 조건이 있습니다. 즉, Windows Server 2008 및 Windows Vista에 유효한 구조체는 SP3이 있는 Windows XP 또는 SP2를 사용하는 Windows XP용 무선 LAN API에 유효하지 않을 수 있습니다. 제약 조건 목록은 WLAN_CONNECTION_PARAMETERS 참조하세요.

pReserved

다음에 사용하도록 예약됩니다. NULL로 설정해야 합니다.

반환 값

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

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

반환 코드 설명
ERROR_INVALID_PARAMETER
 다음 조건 중 하나가 발생했습니다.
  • hClientHandle 이 NULL 이거나 잘못되었습니다.
  • pInterfaceGuid 는 NULL입니다.
  • pConnectionParameters 는 NULL입니다.
  • pConnectionParameters가 가리키는 구조체의 dwFlags 멤버가 WLAN_CONNECTION_PARAMETERS 페이지에 지정된 값 중 하나로 설정되지 않았습니다.
  • pConnectionParameters가 가리키는 구조체의 wlanConnectionMode 멤버는 wlan_connection_mode_discovery_secure 또는 wlan_connection_mode_discovery_unsecure 설정되고 동일한 구조체의 pDot11Ssid 멤버는 NULL입니다.
  • pConnectionParameters가 가리키는 구조체의 wlanConnectionMode 멤버는 wlan_connection_mode_discovery_secure 또는 wlan_connection_mode_discovery_unsecure 설정되고 동일한 구조체의 dot11BssType 멤버는 dot11_BSS_type_any 설정됩니다.
  • pConnectionParameters가 가리키는 구조체의 wlanConnectionMode 멤버가 wlan_connection_mode_profile 설정되고 동일한 구조체의 strProfile 멤버가 NULL이거나 프로필 길이가 WLAN_MAX_NAME_LENGTH 초과합니다.
  • pConnectionParameters가 가리키는 구조체의 wlanConnectionMode 멤버가 wlan_connection_mode_profile 설정되고 동일한 구조체의 strProfile 멤버가 NULL이거나 프로필 길이가 0입니다.
  • pConnectionParameters가 가리키는 구조체의 wlanConnectionMode 멤버는 wlan_connection_mode_invalid 또는 wlan_connection_mode_auto 설정됩니다.
  • pConnectionParameters가 가리키는 구조체의 dot11BssType 멤버가 dot11_BSS_type_infrastructure 설정되고 동일한 구조체의 dwFlags 멤버가 WLAN_CONNECTION_ADHOC_JOIN_ONLY 설정됩니다.
  • pConnectionParameters가 가리키는 구조체의 dot11BssType 멤버가 dot11_BSS_type_independent 설정되고 동일한 구조체의 dwFlags 멤버가 WLAN_CONNECTION_HIDDEN_NETWORK 설정됩니다.
  • pConnectionParameters가 가리키는 구조체의 dwFlags 멤버가 WLAN_CONNECTION_IGNORE_PRIVACY_BIT 설정되고 동일한 구조체의 wlanConnectionMode 멤버가 wlan_connection_mode_temporary_profile 설정되지 않았거나 동일한 구조체의 dot11BssType 멤버가 dot11_BSS_type_independent 설정됩니다.
ERROR_INVALID_HANDLE
 핸들 테이블에서 hClientHandle 핸들을 찾을 수 없습니다.
RPC_STATUS
 다양한 오류 코드.
ERROR_ACCESS_DENIED
 호출자에게 충분한 권한이 없습니다.

설명

WlanConnect 함수는 즉시 반환됩니다. 연결이 설정되거나 추가 연결을 시도하지 않을 때 알림을 받려면 클라이언트가 WlanRegisterNotification을 호출하여 알림을 등록해야 합니다.

pConnectionParameters가 가리키는 WLAN_CONNECTION_PARAMETERS 구조체의 strProfile 멤버는 연결에 사용할 프로필을 지정합니다. 이 프로필이 모든 사용자 프로필인 경우 WlanConnect 호출자는 프로필에 대한 실행 액세스 권한이 있어야 합니다. 그렇지 않으면 반환 값이 ERROR_ACCESS_DENIED WlanConnect 호출이 실패합니다. 모든 사용자 프로필에 대한 권한은 WlanSetProfile 또는 WlanSaveTemporaryProfile을 사용하여 프로필을 만들거나 저장할 때 설정됩니다.

명령줄에서 연결 작업을 수행하려면 netsh wlan connect 명령을 사용합니다. 자세한 내용은 무선 로컬 영역 네트워크(wlan)에 대한 Netsh 명령을 참조하세요.

WINDOWS XP SP3 및 Windows XP용 무선 LAN API SP2 사용: WlanConnect를 사용하여 기본 설정 네트워크 목록의 네트워크에만 연결할 수 있습니다. 기본 설정 네트워크 목록에 네트워크를 추가하려면 WlanSetProfile을 호출합니다.

요구 사항

   
지원되는 최소 클라이언트 Windows Vista, WINDOWS XP SP3 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 wlanapi.h(Wlanapi.h 포함)
라이브러리 Wlanapi.lib
DLL Wlanapi.dll
재배포 가능 파일 WINDOWS XP용 무선 LAN API SP2

참고 항목

WLAN_CONNECTION_PARAMETERS

WlanDisconnect