WlanOpenHandle 함수(wlanapi.h)

WlanOpenHandle 함수는 서버에 대한 연결을 엽니다.

구문

DWORD WlanOpenHandle(
  [in]  DWORD   dwClientVersion,
        PVOID   pReserved,
  [out] PDWORD  pdwNegotiatedVersion,
  [out] PHANDLE phClientHandle
);

매개 변수

[in] dwClientVersion

클라이언트가 지원하는 가장 높은 버전의 WLAN API입니다.

값	의미
1	SP3이 있는 Windows XP용 클라이언트 버전 및 SP2를 사용하는 Windows XP용 무선 LAN API.
2	Windows Vista 및 Windows Server 2008용 클라이언트 버전

pReserved

다음에 사용하도록 예약됩니다. NULL로 설정해야 합니다.

[out] pdwNegotiatedVersion

이 세션에서 사용할 WLAN API의 버전입니다. 이 값은 일반적으로 클라이언트와 서버 모두에서 지원되는 가장 높은 버전입니다.

[out] phClientHandle

이 세션에서 사용할 클라이언트에 대한 핸들입니다. 이 핸들은 세션 전체의 다른 함수에서 사용됩니다.

반환 값

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

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

반환 코드	설명
ERROR_INVALID_PARAMETER	pdwNegotiatedVersion 이 NULL이거나 , phClientHandle 이 NULL이거나, pReserved 가 NULL이 아닙니다.
ERROR_NOT_ENOUGH_MEMORY	클라이언트 컨텍스트를 만들기 위해 메모리를 할당하지 못했습니다.
RPC_STATUS	다양한 오류 코드.
ERROR_REMOTE_SESSION_LIMIT_EXCEEDED	서버에서 너무 많은 핸들을 실행했습니다.

설명

dwClientVersion 및 pdwNegotiatedVersion으로 지정된 버전 번호는 주 버전과 부 버전으로 구성된 복합 버전 번호입니다. 주 버전은 하위 단어로 지정되고 부 버전은 상위 단어로 지정됩니다. 매크로 및 WLAN_API_VERSION_MAJOR(_v)WLAN_API_VERSION_MINOR(_v) 는 주 버전과 부 버전 번호를 각각 반환합니다. 매크로 WLAN_API_MAKE_VERSION(_major, _minor)를 사용하여 버전 번호를 생성할 수 있습니다.

SP2를 사용하는 Windows XP용 SP3 및 무선 LAN API가 있는 Windows XP: WlanOpenHandle 은 WZC(무선 제로 구성) 서비스가 시작되지 않았거나 WZC 서비스가 응답하지 않는 경우 오류 메시지를 반환합니다.

요구 사항

지원되는 최소 클라이언트	Windows Vista, WINDOWS XP SP3 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	wlanapi.h(Wlanapi.h 포함)
라이브러리	Wlanapi.lib
DLL	Wlanapi.dll
재배포 가능 파일	SP2를 사용하는 Windows XP용 무선 LAN API

참고 항목

WlanCloseHandle