WFDCloseSession 함수(wlanapi.h)

아티클
12/22/2023

WFDCloseSession 함수는 이전에 WFDStartOpenSession 함수를 성공적으로 호출한 후 세션을 닫습니다.

구문

DWORD WFDCloseSession(
  [in] HANDLE hSessionHandle
);

매개 변수

[in] hSessionHandle

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

반환 값

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

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

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

설명

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

WFDCloseSession 함수는 세션을 닫기 위해 향후 작업 항목을 큐에 대기하므로 연결 끊김이 즉시 수행되지 않을 수 있습니다.

WFDStartOpenSession 호출이 보류 중인 동안 WFDCloseSession 함수를 호출하면 세션이 닫히지 않습니다.

WFDStartOpenSession 함수에 대한 성공적인 비동기 호출에서 반환된 hSessionHandle 매개 변수의 핸들을 WFDCloseSession 함수에 전달하는 것은 호출자의 책임입니다.

유효하고 유효하지 않은 핸들을 사용하여 WFDCloseSession 함수를 호출하면 정의되지 않은 결과가 생성됩니다.

요구 사항

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