다음을 통해 공유

WlanDisconnect 함수(wlanapi.h)

  • 아티클

WlanDisconnect 함수는 현재 네트워크에서 인터페이스의 연결을 끊습니다.

구문

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

매개 변수

[in] hClientHandle

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

[in] pInterfaceGuid

연결이 끊어질 인터페이스의 GUID입니다.

pReserved

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

반환 값

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

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

반환 코드 설명
ERROR_INVALID_PARAMETER
 hClientHandle 이 NULL 이거나 잘못되었거나, pInterfaceGuid 가 NULL이거나, pReserved 가 NULL이 아닙니다.
ERROR_INVALID_HANDLE
 핸들 테이블에서 hClientHandle 핸들을 찾을 수 없습니다.
RPC_STATUS
 다양한 오류 코드.
ERROR_NOT_ENOUGH_MEMORY
 쿼리 결과에 대한 메모리를 할당하지 못했습니다.
ERROR_ACCESS_DENIED
 호출자에게 충분한 권한이 없습니다.

설명

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

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

WINDOWS XP SP3 및 Windows XP용 무선 LAN API SP2: WlanDisconnect 는 연결이 끊긴 네트워크와 연결된 프로필을 수정하는 부작용이 있습니다. WlanDisconnect 호출 후 네트워크 프로필이 주문형 프로필이 됩니다. 무선 제로 구성 서비스는 네트워크가 범위에 있을 때 주문형 프로필을 사용하여 네트워크에 자동으로 연결되지 않습니다. 프로필을 주문형 프로필로 변경하려는 경우가 아니면 WlanConnect를 호출하기 전에 WlanDisconnect를 호출하지 마세요. WlanConnect를 호출하여 네트워크 연결을 설정하면 기존 네트워크 연결이 자동으로 삭제됩니다.

요구 사항

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

참고 항목

WlanConnect