WlanSetSecuritySettings 함수(wlanapi.h)

WlanGetProfileList 함수는 구성 가능한 개체에 대한 보안 설정을 설정합니다.

구문

DWORD WlanSetSecuritySettings(
  [in] HANDLE                hClientHandle,
  [in] WLAN_SECURABLE_OBJECT SecurableObject,
  [in] LPCWSTR               strModifiedSDDL
);

매개 변수

[in] hClientHandle

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

[in] SecurableObject

보안 설정을 적용할 개체를 지정하는 WLAN_SECURABLE_OBJECT 값입니다.

[in] strModifiedSDDL

개체에 대한 새 보안 설정을 지정하는 보안 설명자 문자열입니다. 이 문자열은 NULL로 종료되어야 합니다. 자세한 내용은 주의 섹션을 참조하세요.

반환 값

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

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

반환 코드	설명
ERROR_INVALID_PARAMETER	매개 변수가 잘못되었습니다. 다음 조건이 발생하면 이 오류가 반환됩니다. hClientHandle 은 NULL입니다. strModifiedSDDL 은 NULL입니다. SecurableObject 는 WLAN_SECURABLE_OBJECT_COUNT (12)보다 크거나 같은 값으로 설정됩니다.
ERROR_INVALID_HANDLE	핸들이 잘못되었습니다. hClientHandle 매개 변수에 지정된 핸들이 핸들 테이블에 없는 경우 이 오류가 반환됩니다.
ERROR_ACCESS_DENIED	호출자에게 충분한 권한이 없습니다.
ERROR_NOT_SUPPORTED	이 함수는 지원되지 않는 플랫폼에서 호출되었습니다. SP3이 있는 Windows XP 또는 SP2 클라이언트를 사용하는 Windows XP용 무선 LAN API에서 이 함수가 호출된 경우 이 값이 반환됩니다.

설명

WlanSetSecuritySettings 함수를 성공적으로 호출하면 개체와 연결된 기본 권한이 재정의됩니다. 기본 권한에 대한 자세한 내용은 네이티브 Wifi API 권한을 참조하세요.

다음은 보안 설명자 개체를 만들고 문자열로 구문 분석하는 절차를 설명합니다.

1. InitializeSecurityDescriptor를 호출하여 메모리에 보안 설명자를 만듭니다.
2. SetSecurityDescriptorOwner를 호출하여 보안 설명자에 대한 소유자 정보를 설정합니다.
3. InitializeAcl을 호출하여 메모리에 DACL(임의 액세스 제어 목록)을 만듭니다.
4. AddAccessAllowedAce 또는 AddAccessDeniedAce를 호출하여 DACL에 ACE(액세스 제어 항목)를 추가합니다. AccessMask 매개 변수를 다음과 같은 비트 OR 조합 중 하나로 적절하게 설정합니다.
   • WLAN_READ_ACCESS
   • WLAN_READ_ACCESS | WLAN_EXECUTE_ACCESS
   • WLAN_READ_ACCESS | WLAN_EXECUTE_ACCESS | WLAN_WRITE_ACCESS
5. SetSecurityDescriptorDacl을 호출하여 보안 설명자에 DACL을 추가합니다.
6. ConvertSecurityDescriptorToStringSecurityDescriptor를 호출하여 설명자를 문자열로 변환합니다.

그런 다음, WlanSetSecuritySettings를 호출할 때 ConvertSecurityDescriptorToStringSecurityDescriptor에서 반환된 문자열을 strModifiedSDDL 매개 변수 값으로 사용할 수 있습니다.

요구 사항

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

참고 항목

네이티브 Wifi API 권한

WlanGetSecuritySettings