WFDStartOpenSession 함수(wlanapi.h)

아티클
03/04/2024

WFDStartOpenSession 함수는 이전에 Windows 페어링 환경을 통해 페어링된 특정 Wi-Fi Direct 디바이스에 대한 주문형 연결을 시작합니다.

구문

DWORD WFDStartOpenSession(
  [in]           HANDLE                             hClientHandle,
  [in]           PDOT11_MAC_ADDRESS                 pDeviceAddress,
  [in, optional] PVOID                              pvContext,
  [in]           WFD_OPEN_SESSION_COMPLETE_CALLBACK pfnCallback,
  [out]          PHANDLE                            phSessionHandle
);

매개 변수

[in] hClientHandle

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

[in] pDeviceAddress

대상 디바이스의 Wi-Fi 직접 디바이스 주소에 대한 포인터입니다. 대상 Wi-Fi 디바이스의 MAC 주소입니다.

[in, optional] pvContext

pfnCallback 매개 변수에 지정된 콜백 함수에 전달되는 선택적 컨텍스트 포인터입니다.

[in] pfnCallback

WFDStartOpenSession 요청이 완료되면 호출할 콜백 함수에 대한 포인터입니다.

[out] phSessionHandle

이 특정 Wi-Fi 직접 세션에 대한 핸들입니다.

반환 값

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

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

반환 코드	설명
ERROR_INVALID_HANDLE	핸들이 잘못되었습니다. hClientHandle 매개 변수에 지정된 핸들이 핸들 테이블에 없는 경우 이 오류가 반환됩니다.
ERROR_INVALID_PARAMETER	매개 변수가 올바르지 않습니다. hClientHandle 매개 변수가 NULL이거나 유효하지 않은 경우 이 오류가 반환됩니다. pDeviceAddress 매개 변수가 NULL이거나, pfnCallback 매개 변수가 NULL이거나, phSessionHandle 매개 변수가 NULL인 경우에도 이 오류가 반환됩니다. dwClientVersion 매개 변수가 WFD_API_VERSION 같지 않은 경우에도 이 값이 반환됩니다.
ERROR_INVALID_STATE	그룹 또는 리소스가 요청된 작업을 수행하기에 올바른 상태가 아닙니다. 이 오류는 도메인의 그룹 정책에 의해 Wi-Fi Direct 서비스를 사용하지 않도록 설정한 경우 반환됩니다.
ERROR_SERVICE_NOT_ACTIVE	서비스가 시작되지 않았습니다. WLAN AutoConfig 서비스가 실행되고 있지 않으면 이 오류가 반환됩니다.
RPC_STATUS	다양한 오류 코드.

설명

WFDStartOpenSession 함수는 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 솔루션을 제공하는 것입니다.

WFDStartOpenSession 함수는 비동기 작업을 시작하여 특정 Wi-Fi Direct 디바이스에 대한 주문형 연결을 시작합니다. 대상 Wi-Fi 디바이스는 이전에 Windows 페어링 환경을 통해 페어링되어야 합니다. 비동기 작업이 완료되면 pfnCallback 매개 변수에 지정된 콜백 함수가 호출됩니다.

애플리케이션이 WFDStartOpenSession 함수가 비동기적으로 완료되기 전에 WFDCloseHandle 함수를 호출하여 Wi-Fi Direct 서비스에 대한 핸들을 닫으려고 하면 WFDStartOpenSession 호출이 완료될 때까지 WFDCloseHandle 함수가 대기합니다.

요구 사항

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