WFDCancelOpenSession 함수(wlanapi.h)

아티클
03/04/2024

WFDCancelOpenSession 함수는 애플리케이션이 완료되지 않은 보류 중인 WFDStartOpenSession 함수를 취소하려고 했음을 나타냅니다.

구문

DWORD WFDCancelOpenSession(
  [in] HANDLE hSessionHandle
);

매개 변수

[in] hSessionHandle

취소할 Wi-Fi 직접 세션에 대한 세션 핸들입니다. WFDStartOpenSession 함수에서 이전에 반환한 세션 핸들입니다.

반환 값

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

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

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

설명

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

WFDCancelOpenSession 함수에 대한 호출은 Wi-Fi Direct 서비스에 클라이언트가 이 세션의 취소를 요청하도록 알릴 수 있습니다. WFDCancelOpenSession 함수는 예상된 WFDStartOpenSession 동작을 수정하지 않습니다. WFDStartOpenSession 함수에 지정된 콜백 함수는 계속 호출되며 WFDStartOpenSession 함수는 즉시 완료되지 않을 수 있습니다.

WFDStartOpenSession 함수 호출에서 반환된 hSessionHandle 매개 변수의 핸들을 WFDCancelOpenSession 함수에 전달하는 것은 호출자의 책임입니다.

요구 사항

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