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.
함수가 실패하면 반환 값은 다음 반환 코드 중 하나일 수 있습니다.
| 반환 코드 | 설명 |
|---|---|
|
다음 조건 중 하나가 발생했습니다.
|
|
핸들 테이블에서 hClientHandle 핸들을 찾을 수 없습니다. |
|
다양한 오류 코드. |
|
호출자에게 충분한 권한이 없습니다. |
설명
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 |