WFDCloseHandle 함수(wlanapi.h)

아티클
08/28/2023

WFDCloseHandle 함수는 Wi-Fi Direct 서비스에 대한 핸들을 닫습니다.

구문

DWORD WFDCloseHandle(
  [in] HANDLE hClientHandle
);

매개 변수

[in] hClientHandle

Wi-Fi Direct 서비스에 대한 클라이언트 핸들입니다. 이 핸들은 WFDOpenHandle 함수에 대한 이전 호출에서 얻은 것입니다.

반환 값

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

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

반환 코드	설명
ERROR_INVALID_HANDLE	핸들이 잘못되었습니다. hClientHandle 매개 변수에 지정된 핸들이 핸들 테이블에 없는 경우 이 오류가 반환됩니다.
ERROR_INVALID_PARAMETER	매개 변수가 올바르지 않습니다. hClientHandle 매개 변수가 NULL이거나 유효하지 않은 경우 이 오류가 반환됩니다.
RPC_STATUS	다양한 오류 코드.

설명

WFDCloseHandle 함수는 Windows 8 및 Windows Server 2012 새로운 기능인 Wi-Fi Direct의 일부입니다. Wi-Fi Direct는 Wi-Fi Alliance의 Wi-Fi 피어 투 피어 기술 사양 v1.1 개발을 기반으로 합니다(Wi-Fi Alliance 게시된 사양 참조). Wi-Fi 피어 투 피어 기술 사양의 목표는 무선 AP(무선 액세스 지점)가 연결을 설정하거나 기존 IBSS(Wi-Fi adhoc) 메커니즘을 사용할 필요 없이 디바이스 간 연결을 Wi-Fi 솔루션을 제공하는 것입니다.

Wi-Fi Direct를 사용하려면 애플리케이션이 먼저 WFDOpenHandle 함수를 호출하여 Wi-Fi Direct 서비스에 대한 핸들을 가져와야 합니다. WFDOpenHandle 함수에서 반환된 Wi-Fi Direct(WFD) 핸들은 Wi-Fi Direct 서비스에 대한 후속 호출에 사용됩니다. Wi-Fi Direct 서비스를 사용하여 애플리케이션이 완료되면 애플리케이션은 WFDCloseHandle 함수를 호출하여 애플리케이션이 서비스를 사용하여 수행되었음을 Wi-Fi Direct 서비스에 신호를 보내야 합니다. 이렇게 하면 Wi-Fi Direct 서비스가 애플리케이션에서 사용하는 리소스를 해제할 수 있습니다.

요구 사항


지원되는 최소 클라이언트	Windows 8 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2012 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	wlanapi.h
라이브러리	Wlanapi.lib
DLL	Wlanapi.dll