다음을 통해 공유

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