LsaSetInformationPolicy 함수(ntsecapi.h)
LsaSetInformationPolicy 함수는 Policy 개체의 정보를 수정합니다.
구문
NTSTATUS LsaSetInformationPolicy(
[in] LSA_HANDLE PolicyHandle,
[in] POLICY_INFORMATION_CLASS InformationClass,
[in] PVOID Buffer
);
매개 변수
[in] PolicyHandle
Policy 개체에 대한 핸들입니다. 이 핸들에 필요한 액세스 권한은 InformationClass 매개 변수의 값에 따라 달라집니다. 자세한 내용은 정책 개체 핸들 열기를 참조하세요.
[in] InformationClass
POLICY_INFORMATION_CLASS 열거형 형식에서 다음 값 중 하나를 지정합니다. 값은 설정할 정보의 형식을 나타냅니다.
| 값 | 의미 |
|---|---|
|
시스템의 감사 규칙을 설정합니다. PolicyHandle 매개 변수에 전달된 핸들에는 POLICY_SET_AUDIT_REQUIREMENTS 액세스 권한이 있어야 합니다. Buffer 매개 변수는 POLICY_AUDIT_EVENTS_INFO 구조체에 대한 포인터여야 합니다. |
|
시스템 기본 도메인의 이름 및 SID를 설정합니다. PolicyHandle 매개 변수에 전달된 핸들에는 POLICY_TRUST_ADMIN 액세스 권한이 있어야 합니다. Buffer 매개 변수는 POLICY_PRIMARY_DOMAIN_INFO 구조체에 대한 포인터여야 합니다. |
|
시스템 계정 도메인의 이름 및 SID를 설정합니다. PolicyHandle 매개 변수에 전달된 핸들에는 POLICY_TRUST_ADMIN 액세스 권한이 있어야 합니다. Buffer 매개 변수는 POLICY_ACCOUNT_DOMAIN_INFO 구조체에 대한 포인터여야 합니다. |
|
Policy 개체와 연결된 기본 도메인에 대한 DNS(도메인 이름 시스템) 정보를 설정합니다. PolicyHandle 매개 변수에 전달된 핸들에는 POLICY_TRUST_ADMIN 액세스 권한이 있어야 합니다. Buffer 매개 변수는 POLICY_DNS_DOMAIN_INFO 구조체에 대한 포인터여야 합니다. |
|
LSA 서버의 역할을 설정합니다.
PolicyHandle 매개 변수에 전달된 핸들에는 POLICY_SERVER_ADMIN 액세스 권한이 있어야 합니다.
Buffer 매개 변수는 POLICY_LSA_SERVER_ROLE_INFO 구조체에 대한 포인터여야 합니다.
서버의 역할을 주 서버에서 백업으로 변경해도 아무런 영향을 주지 않습니다(함수가 STATUS_SUCCESS 반환함). 서버 역할을 백업에서 주 서버로 변경하려면 광범위한 네트워크 작업이 필요하며 속도가 느릴 수 있습니다. |
[in] Buffer
설정할 정보를 포함하는 구조체에 대한 포인터입니다. 구조체의 형식은 InformationClass 매개 변수의 값에 따라 달라집니다.
반환 값
함수가 성공하면 반환 값이 STATUS_SUCCESS.
함수가 실패하면 반환 값은 NTSTATUS 코드입니다. 자세한 내용은 LSA 정책 함수 반환 값을 참조하세요.
LsaNtStatusToWinError 함수를 사용하여 NTSTATUS 코드를 Windows 오류 코드로 변환할 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | ntsecapi.h |
| 라이브러리 | Advapi32.lib |
| DLL | Advapi32.dll |