WlanQueryAutoConfigParameter 함수(wlanapi.h)
WlanQueryAutoConfigParameter 함수는 자동 구성 서비스의 매개 변수를 쿼리합니다.
구문
DWORD WlanQueryAutoConfigParameter(
[in] HANDLE hClientHandle,
[in] WLAN_AUTOCONF_OPCODE OpCode,
PVOID pReserved,
[out] PDWORD pdwDataSize,
[out] PVOID *ppData,
[out, optional] PWLAN_OPCODE_VALUE_TYPE pWlanOpcodeValueType
);
매개 변수
[in] hClientHandle
WlanOpenHandle 함수에 대한 이전 호출에서 얻은 클라이언트의 세션 핸들입니다.
[in] OpCode
쿼리할 구성 매개 변수를 지정하는 값입니다.
| 값 | 의미 |
|---|---|
|
설정되면 ppData 매개 변수에 사용자 및 그룹 정책 거부 네트워크가 사용 가능한 네트워크 목록에 포함될지 여부를 나타내는 BOOL 값이 포함됩니다.
함수가 ERROR_SUCCESS 반환하고 ppData 가 TRUE를 가리키면 사용자 및 그룹 정책 거부 네트워크가 사용 가능한 네트워크 목록에 포함됩니다. FALSE이면 사용자 및 그룹 정책 거부 네트워크가 사용 가능한 네트워크 목록에 포함되지 않습니다. |
|
설정되면 ppData 매개 변수에는 전원 설정을 지정하는 WLAN_POWER_SETTING 값이 포함됩니다. |
|
설정되면 ppData 매개 변수에는 그룹 정책으로 생성되지 않은 프로필을 일치하는 그룹 정책 프로필로 허용된 네트워크에 연결하는 데 사용할 수 있는지 여부를 나타내는 BOOL 값이 포함됩니다.
함수가 ERROR_SUCCESS 반환하고 ppData 가 TRUE를 가리키는 경우 그룹 정책에서 만든 프로필만 사용할 수 있습니다. FALSE이면 모든 프로필을 사용할 수 있습니다. |
|
설정되면 ppData 매개 변수에는 현재 무선 인터페이스에 공유 사용자 자격 증명이 허용되는지 여부를 나타내는 BOOL 값이 포함됩니다.
함수가 ERROR_SUCCESS 반환하고 ppData 가 TRUE를 가리키는 경우 현재 무선 인터페이스에 공유 사용자 자격 증명이 허용됩니다. FALSE이면 현재 무선 인터페이스에서 공유 사용자 자격 증명을 허용하지 않습니다. |
|
설정되면 ppData 매개 변수에 현재 무선 인터페이스의 차단된 기간 설정을 나타내는 DWORD 값이 포함됩니다. 차단된 기간은 이전 오류 후 무선 네트워크에 대한 자동 연결을 시도하지 않는 시간(초)입니다. |
|
설정되면 ppData 매개 변수에 가상 스테이션의 확장성이 허용되는지 여부를 나타내는 BOOL 값이 포함됩니다. 기본적으로 가상 스테이션의 확장성이 허용됩니다. 이 opcode의 값은 다시 시작할 때 유지됩니다.
함수가 ERROR_SUCCESS 반환하고 ppData 가 TRUE를 가리키면 가상 스테이션에서 확장이 허용됩니다. FALSE이면 가상 스테이션에서 확장이 허용되지 않습니다. |
pReserved
다음에 사용하도록 예약됩니다. NULL로 설정해야 합니다.
[out] pdwDataSize
ppData 매개 변수의 크기를 바이트 단위로 지정합니다.
[out] ppData
OpCode에 지정된 매개 변수에 대해 쿼리된 값을 포함하는 메모리에 대한 포인터입니다.
[out, optional] pWlanOpcodeValueType
WLAN_OPCODE_VALUE_TYPE 값입니다.
반환 값
함수가 성공하면 반환 값이 ERROR_SUCCESS.
함수가 실패하면 반환 값은 다음 반환 코드 중 하나일 수 있습니다.
| 반환 코드 | 설명 |
|---|---|
|
호출자에게 구성 매개 변수를 가져올 수 있는 충분한 권한이 없습니다.
OpCode가 wlan_autoconf_opcode_show_denied_networks 설정된 상태에서 호출되면 WlanQueryAutoConfigParameter는 wlan_secure_show_denied 개체와 함께 저장된 DACL(임의 액세스 제어 목록)을 검색합니다. DACL에 호출 스레드의 액세스 토큰에 대한 WLAN_READ_ACCESS 권한을 부여하는 ACE(액세스 제어 항목)가 없는 경우 WlanQueryAutoConfigParameter 는 ERROR_ACCESS_DENIED 반환합니다. |
|
hClientHandle 이 NULL 이거나 잘못되었거나, pReserved 가 NULL이 아니거나, ppData 가 NULL이거나, pdwDataSize 가 NULL입니다. |
|
핸들 테이블에서 hClientHandle 핸들을 찾을 수 없습니다. |
|
이 함수는 지원되지 않는 플랫폼에서 호출되었습니다. SP3이 있는 Windows XP 또는 SP2 클라이언트를 사용하는 Windows XP용 무선 LAN API에서 이 함수가 호출된 경우 이 값이 반환됩니다. |
|
다양한 오류 코드. |
설명
WlanQueryAutoConfigParameter 함수는 Windows Vista 이상에서 지원되는 무선 구성 구성 요소인 ACM(자동 구성 모듈)에서 사용하는 매개 변수를 쿼리합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | wlanapi.h(Wlanapi.h 포함) |
| 라이브러리 | Wlanapi.lib |
| DLL | Wlanapi.dll |