WFD_OPEN_SESSION_COMPLETE_CALLBACK 콜백 함수(wlanapi.h)

아티클
03/13/2024

WFD_OPEN_SESSION_COMPLETE_CALLBACK 함수는 WFDStartOpenSession 작업이 완료된 경우 WFDStartOpenSession 함수에서 호출 하는 콜백 함수를 정의합니다.

구문

WFD_OPEN_SESSION_COMPLETE_CALLBACK WfdOpenSessionCompleteCallback;

void WfdOpenSessionCompleteCallback(
  [in] HANDLE hSessionHandle,
  [in] PVOID pvContext,
  [in] GUID guidSessionInterface,
  [in] DWORD dwError,
  [in] DWORD dwReasonCode
)
{...}

매개 변수

[in] hSessionHandle

Wi-Fi Direct 세션에 대한 세션 핸들입니다. WFDStartOpenSession 함수에서 이전에 반환한 세션 핸들입니다.

[in] pvContext

WFDStartOpenSession 함수에서 콜백 함수에 전달된 컨텍스트 포인터입니다.

[in] guidSessionInterface

이 Wi-Fi Direct 디바이스에 열려 있는 세션이 있는 로컬 네트워크 인터페이스의 인터페이스 GUID입니다. 이 매개 변수는 상위 계층 프로토콜이 Wi-Fi 직접 세션이 바인딩된 네트워크 인터페이스를 결정해야 하는 경우에 유용합니다. 이 값은 dwError 매개 변수가 ERROR_SUCCESS 경우에만 반환됩니다.

[in] dwError

WFDStartOpenSession 함수를 호출하는 동안 오류가 발생했는지 여부를 지정하는 값입니다. 이 값이 ERROR_SUCCESS 오류가 발생하지 않고 세션을 여는 작업이 성공적으로 완료되었습니다.

다음과 같은 다른 값이 가능합니다.

값	의미
ERROR_INVALID_PARAMETER	매개 변수가 올바르지 않습니다. hClientHandle 매개 변수가 NULL이거나 유효하지 않은 경우 이 오류가 반환됩니다.
ERROR_INVALID_STATE	그룹 또는 리소스가 요청된 작업을 수행하기에 올바른 상태가 아닙니다. 이 오류는 도메인의 그룹 정책에 의해 Wi-Fi Direct 서비스를 사용하지 않도록 설정한 경우 반환됩니다.
ERROR_SERVICE_NOT_ACTIVE	서비스가 시작되지 않았습니다. WLAN AutoConfig 서비스가 실행되고 있지 않으면 이 오류가 반환됩니다.
RPC_STATUS	다양한 RPC 및 기타 오류 코드. FormatMessage를 사용하여 반환된 오류에 대한 메시지 문자열을 가져옵니다.

[in] dwReasonCode

WFDStartOpenSession 중에 오류가 발생한 경우 더 자세한 정보를 지정하는 값입니다.

반환 값

없음

설명

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

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

요구 사항

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