WFDOpenHandle 함수(wlanapi.h)

아티클
03/04/2024

WFDOpenHandle 함수는 Wi-Fi Direct 서비스에 대한 핸들을 열고 사용할 Wi-FI Direct API 버전을 협상합니다.

구문

DWORD WFDOpenHandle(
  [in]  DWORD   dwClientVersion,
  [out] PDWORD  pdwNegotiatedVersion,
  [out] PHANDLE phClientHandle
);

매개 변수

[in] dwClientVersion

클라이언트에서 지원하는 Wi-Fi Direct API의 가장 높은 버전입니다.

Windows 8 및 Windows Server 2012 경우 이 매개 변수는 Wlanapi.h 헤더 파일에 정의된 상수인 WFD_API_VERSION 설정해야 합니다.

[out] pdwNegotiatedVersion

협상된 버전을 받을 DWORD 에 대한 포인터입니다.

WFDOpenHandle 함수가 성공하면 이 세션에서 사용할 Wi-Fi Direct Service와 협상된 버전이 반환됩니다. 이 값은 일반적으로 클라이언트 및 Wi-Fi Direct 서비스에서 지원하는 가장 높은 버전입니다.

[out] phClientHandle

이 세션의 Wi-Fi Direct 서비스에 대한 핸들을 수신하는 HANDLE 에 대한 포인터입니다.

WFDOpenHandle 함수가 성공하면 이 세션에서 사용할 Wi-Fi Direct 서비스에 대한 핸들이 반환됩니다.

반환 값

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

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

반환 코드	설명
ERROR_INVALID_PARAMETER	매개 변수가 올바르지 않습니다. pdwNegotiatedVersion 매개 변수가 NULL이거나 phClientHandle 매개 변수가 NULL인 경우 이 오류가 반환됩니다. dwClientVersion 매개 변수가 WFD_API_VERSION 같지 않은 경우에도 이 값이 반환됩니다.
ERROR_NOT_ENOUGH_MEMORY	이 명령을 처리하는 데 사용할 수 있는 스토리지가 부족합니다. 시스템에서 클라이언트 컨텍스트를 만들기 위해 메모리를 할당할 수 없는 경우 이 오류가 반환됩니다.
ERROR_REMOTE_SESSION_LIMIT_EXCEEDED	네트워크 서버에 대한 세션을 설정하려고 했지만 해당 서버로 설정된 세션이 이미 너무 많습니다. Wi-Fi Direct 서비스에서 너무 많은 핸들을 실행한 경우 이 오류가 반환됩니다.
RPC_STATUS	다양한 오류 코드.

설명

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

Wi-Fi Direct를 사용하려면 애플리케이션이 먼저 WFDOpenHandle 함수를 호출하여 Wi-Fi Direct 서비스에 대한 핸들을 가져와야 합니다. WFDOpenHandle 함수에서 반환된 WFD(Wi-Fi Direct) 핸들은 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