다음을 통해 공유

WlanIhvControl 함수(wlanapi.h)

  • 아티클

WlanIhvControl 함수는 WLAN 드라이버 또는 서비스의 IHV(독립 하드웨어 공급업체) 제어를 위한 메커니즘을 제공합니다.

구문

DWORD WlanIhvControl(
  [in]                HANDLE                hClientHandle,
  [in]                const GUID            *pInterfaceGuid,
  [in]                WLAN_IHV_CONTROL_TYPE Type,
  [in]                DWORD                 dwInBufferSize,
  [in]                PVOID                 pInBuffer,
  [in]                DWORD                 dwOutBufferSize,
  [in, out, optional] PVOID                 pOutBuffer,
  [out]               PDWORD                pdwBytesReturned
);

매개 변수

[in] hClientHandle

WlanOpenHandle 함수에 대한 이전 호출에서 얻은 클라이언트의 세션 핸들입니다.

[in] pInterfaceGuid

인터페이스의 GUID입니다.

[in] Type

IHV 컨트롤 함수에서 우회하는 소프트웨어 유형을 지정하는 WLAN_IHV_CONTROL_TYPE 구조체입니다.

[in] dwInBufferSize

입력 버퍼의 크기(바이트)입니다.

[in] pInBuffer

드라이버 또는 서비스 인터페이스 입력에 대한 제네릭 버퍼입니다.

[in] dwOutBufferSize

출력 버퍼의 크기(바이트)입니다.

[in, out, optional] pOutBuffer

드라이버 또는 서비스 인터페이스 출력에 대한 제네릭 버퍼입니다.

[out] pdwBytesReturned

반환된 바이트 수입니다.

반환 값

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

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

반환 코드 설명
ERROR_ACCESS_DENIED
 호출자에게 이 작업을 수행할 수 있는 충분한 권한이 없습니다. 호출되면 WlanIhvControl 은 wlan_secure_ihv_control 개체와 함께 저장된 DACL(임의 액세스 제어 목록)을 검색합니다. DACL에 호출 스레드의 액세스 토큰에 대한 WLAN_WRITE_ACCESS 권한을 부여하는 ACE(액세스 제어 항목)가 없는 경우 WlanIhvControl 은 ERROR_ACCESS_DENIED 반환합니다.
ERROR_INVALID_PARAMETER
 hClientHandle 이 NULL 이거나 잘못되었거나 , pInterfaceGuid 가 NULL이거나, pdwBytesReturned 이 NULL입니다.
ERROR_INVALID_HANDLE
 핸들 테이블에 hClientHandle 핸들을 찾을 수 없습니다.
ERROR_NOT_SUPPORTED
 이 함수는 지원되지 않는 플랫폼에서 호출되었습니다. SP3이 있는 Windows XP 또는 SP2 클라이언트가 있는 Windows XP용 무선 LAN API에서 이 함수를 호출한 경우 이 값이 반환됩니다.
RPC_STATUS
 다양한 오류 코드.

요구 사항

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

추가 정보

WLAN_IHV_CONTROL_TYPE