WFDOpenLegacySession 함수(wlanapi.h)

아티클
12/22/2023

WFDOpenLegacySession 함수는 Wi-Fi Direct 레거시 디바이스에 대해 저장된 프로필을 검색하고 적용합니다.

구문

DWORD WFDOpenLegacySession(
  HANDLE             hClientHandle,
  PDOT11_MAC_ADDRESS pLegacyMacAddress,
  HANDLE             *phSessionHandle,
  GUID               *pGuidSessionInterface
);

매개 변수

hClientHandle

이 세션에 대한 Wi-Fi Direct 서비스에 대한 핸들 입니다. 이 매개 변수는 WFDOpenHandle 함수를 사용하여 검색됩니다.

pLegacyMacAddress

레거시 클라이언트 디바이스의 Wi-Fi 직접 디바이스 주소에 대한 포인터입니다.

phSessionHandle

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

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

pGuidSessionInterface

이 세션에 대한 네트워크 인터페이스의 GUID에 대한 포인터입니다.

WFDOpenLegacySession 함수가 성공하면 Wi-Fi 직접 세션이 반환되는 네트워크 인터페이스의 GUID입니다.

반환 값

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

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

반환 코드	설명
ERROR_INVALID_PARAMETER	매개 변수가 올바르지 않습니다. phClientHandle 또는 pLegacyMacAddress 매개 변수가 NULL인 경우 이 오류가 반환됩니다.
ERROR_NOT_ENOUGH_MEMORY	이 명령을 처리하는 데 사용할 수 있는 스토리지가 부족합니다. 시스템에서 클라이언트 컨텍스트를 만들기 위해 메모리를 할당할 수 없는 경우 이 오류가 반환됩니다.
RPC_STATUS	다양한 오류 코드.

설명

WFDOpenLegacySession 함수는 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를 사용하려면 애플리케이션이 먼저 WFDOpenLegacySession 또는 WFDOpenHandle 함수를 호출하여 Wi-Fi Direct 서비스에 대한 핸들을 가져와야 합니다. WFDOpenHandle 함수에서 반환된 WFD(Wi-Fi Direct) 핸들은 Wi-Fi Direct 서비스에 대한 후속 호출에 사용됩니다. WFDOpenLegacySession 함수는 Wi-Fi Direct 레거시 디바이스에 대해 저장된 프로필을 검색하고 적용하는 데 사용됩니다.

WFDOpenLegacySession 함수는 지정된 레거시 디바이스 주소에 대한 프로필 저장소에서 디바이스에 저장된 레거시 프로필을 검색합니다. 이 디바이스 주소는 받은 편지함 페어링 환경(레거시 WPS 페어링)의 결과로 만든 디바이스 노드에서 가져와야 합니다.

Wi-Fi Direct 서비스를 사용하여 애플리케이션이 완료되면 애플리케이션은 WFDCloseSession 함수를 호출하여 세션을 닫고 WFDCloseHandle 함수를 호출하여 애플리케이션이 서비스를 사용하여 수행되었음을 Wi-Fi Direct 서비스에 신호를 보내야 합니다. 이렇게 하면 Wi-Fi Direct 서비스가 애플리케이션에서 사용하는 리소스를 해제할 수 있습니다.

요구 사항

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