IGroupPolicyObject::SetOptions 메서드(gpedit.h)

아티클
08/24/2023

SetOptions 메서드는 GPO에 대한 옵션을 설정합니다.

구문

HRESULT SetOptions(
  [in] DWORD dwOptions,
  [in] DWORD dwMask
);

매개 변수

[in] dwOptions

새 옵션 값을 지정합니다. 이 매개 변수는 다음 옵션 중 하나 이상일 수 있습니다. 자세한 내용은 아래 설명 부분을 참조하십시오.

GPO_OPTION_DISABLE_USER

GPO의 사용자 부분을 사용하지 않도록 설정합니다.

GPO_OPTION_DISABLE_MACHINE

GPO의 컴퓨터 부분을 사용하지 않도록 설정합니다.

[in] dwMask

변경할 옵션을 지정합니다. 이 매개 변수는 다음 옵션 중 하나 이상일 수 있습니다. 자세한 내용은 아래 설명 부분을 참조하십시오.

GPO_OPTION_DISABLE_USER

GPO의 사용자 부분을 사용하지 않도록 설정합니다.

GPO_OPTION_DISABLE_MACHINE

GPO의 컴퓨터 부분을 사용하지 않도록 설정합니다.

반환 값

메서드가 성공하면 반환 값이 S_OK. 그렇지 않으면 메서드는 플랫폼 SDK 헤더 파일 WinError.h에 정의된 COM 오류 코드 중 하나를 반환합니다.

설명

참고SetOptions 메서드를 사용하여 로컬 그룹 정책 개체의 사용자 또는 컴퓨터 부분을 사용하거나 사용하지 않도록 설정하면 정책 새로 고침이 자동으로 트리거됩니다.

옵션을 변경하려면 dwMask 매개 변수에 적절한 플래그를 설정해야 합니다. 플래그가 설정된 경우 시스템은 dwOptions 매개 변수를 읽어 새 상태를 설정합니다. 예를 들어 GPO의 사용자 부분을 사용하지 않도록 설정하고 컴퓨터 부분을 변경하지 않은 상태로 두려면 다음과 같이 SetOptions 메서드를 호출합니다.

SetOptions(GPO_OPTION_DISABLE_USER, GPO_OPTION_DISABLE_USER)

사용자 부분을 사용하도록 설정하고 컴퓨터 부분을 사용하지 않도록 설정하려면 다음과 같이 SetOptions 메서드를 호출합니다.

SetOptions(GPO_OPTION_DISABLE_MACHINE, GPO_OPTION_DISABLE_USER | GPO_OPTION_DISABLE_MACHINE)

GPO에 대한 옵션을 검색하려면 GetOptions 메서드를 호출할 수 있습니다.

요구 사항


지원되는 최소 클라이언트	Windows Vista
지원되는 최소 서버	Windows Server 2008
대상 플랫폼	Windows
헤더	gpedit.h
DLL	Gpedit.dll