그룹 정책 API
그룹 정책 API 기술 개요입니다.
그룹 정책 API를 개발하려면 다음 헤더가 필요합니다.
이 기술에 대한 프로그래밍 지침은 다음을 참조하세요.
열거형
| INSTALLSPECTYPE INSTALLSPECTYPE 열거형 값은 그룹 정책 애플리케이션을 InstallApplication 함수에 지정할 수 있는 방법을 정의합니다. 값은 INSTALLDATA의 Type 멤버에 사용됩니다. |
Functions
| BrowseForGPO BrowseForGPO 함수는 사용자가 GPO를 열거나 만들 수 있는 GPO 브라우저 대화 상자를 만듭니다. |
| CreateGPOLink CreateGPOLink 함수는 지정된 GPO와 지정된 사이트, 도메인 또는 조직 구성 단위 간에 링크를 만듭니다. |
| 삭제 Delete 메서드는 GPO를 삭제합니다. |
| DeleteAllGPOLinks DeleteAllGPOLinks 함수는 지정된 사이트, 도메인 또는 조직 구성 단위에 대한 모든 GPO 링크를 삭제합니다. |
| DeleteGPOLink DeleteGPOLink 함수는 지정된 GPO와 지정된 사이트, 도메인 또는 조직 구성 단위 간의 링크를 삭제합니다. |
| EnterCriticalPolicySection EnterCriticalPolicySection 함수는 애플리케이션이 정책 설정을 안전하게 읽을 수 있도록 정책 애플리케이션을 일시 중지합니다. |
| ExportRSoPData ExportRSoPData 함수는 RSoP 정보가 포함된 WMI 네임스페이스를 데이터 파일로 내보냅니다. 함수는 ImportRSoPData 함수를 호출하여 WMI 네임스페이스로 가져올 수 있는 데이터 파일에 정보를 씁니다. |
| FreeGPOListA FreeGPOList 함수는 지정된 GPO 목록을 해제합니다. (ANSI) |
| FreeGPOListW FreeGPOList 함수는 지정된 GPO 목록을 해제합니다. (유니코드) |
| GetAppliedGPOListA GetAppliedGPOList 함수는 지정된 사용자 또는 컴퓨터에 적용된 GPO 목록을 검색합니다. (ANSI) |
| GetAppliedGPOListW GetAppliedGPOList 함수는 지정된 사용자 또는 컴퓨터에 적용된 GPO 목록을 검색합니다. (유니코드) |
| GetDisplayName GetDisplayName 메서드는 GPO의 표시 이름을 검색합니다. (IGPEInformation.GetDisplayName) |
| GetDisplayName GetDisplayName 메서드는 GPO의 표시 이름을 검색합니다. (IGroupPolicyObject.GetDisplayName) |
| GetDSPath GetDSPath 메서드는 GPO의 지정된 섹션에 대한 Active Directory 경로를 검색합니다. |
| GetDSPath GetDSPath 메서드는 지정된 GPO 섹션의 루트에 대한 Active Directory 경로를 검색합니다. |
| GetEventLogEntryText GetEventLogEntryText 메서드는 이벤트 로그의 특정 항목에 대한 텍스트를 반환합니다. |
| GetFileSysPath GetFileSysPath 메서드는 GPO의 지정된 섹션에 대한 파일 시스템 경로를 반환합니다. 경로는 UNC 형식입니다. |
| GetFileSysPath GetFileSysPath 메서드는 지정된 GPO 섹션의 루트에 대한 파일 시스템 경로를 검색합니다. 경로는 UNC 형식입니다. |
| GetFlags GetFlags 메서드는 RSoP 사용자 인터페이스 세션에 대한 정보를 검색합니다. |
| GetGPOListA GetGPOList 함수는 지정된 사용자 또는 컴퓨터에 대한 GPO 목록을 검색합니다. (ANSI) |
| GetGPOListW GetGPOList 함수는 지정된 사용자 또는 컴퓨터에 대한 GPO 목록을 검색합니다. (유니코드) |
| GetHint GetHint 메서드는 이 GPO를 연결할 수 있는 Active Directory 개체의 형식을 검색합니다. |
| GetLocalManagedApplications 대상 컴퓨터에서 GetLocalManagedApplications 함수를 실행하여 해당 컴퓨터에서 관리되는 애플리케이션 목록을 가져올 수 있습니다. |
| GetMachineName GetMachineName 메서드는 원격 GPO의 컴퓨터 이름을 검색합니다. OpenRemoteMachineGPO 메서드에서 지정한 이름입니다. |
| GetManagedApplicationCategories GetManagedApplicationCategories 함수는 도메인에 대한 애플리케이션 범주 목록을 가져옵니다. 목록은 도메인의 모든 사용자에 대해 동일합니다. |
| GetManagedApplications GetManagedApplications 함수는 지정된 사용자 컨텍스트에 대한 ARP(프로그램 추가/제거)의 추가 창에 표시되는 애플리케이션 목록을 가져옵니다. |
| GetName GetName 메서드는 GPO의 고유 이름을 검색합니다. 이 값은 일반적으로 GUID입니다. |
| GetName GetName 메서드는 고유한 GPO 이름을 검색합니다. |
| GetNamespace GetNameSpace 메서드는 RSoP 데이터가 표시되는 네임스페이스를 검색합니다. |
| GetOptions GetOptions 메서드는 사용자가 그룹 정책 개체 편집기에서 선택한 옵션을 검색합니다. |
| GetOptions GetOptions 메서드는 GPO에 대한 옵션을 검색합니다. |
| GetPath GetPath 메서드는 GPO의 경로를 검색합니다. |
| GetPropertySheetPages GetPropertySheetPages 메서드는 GPO와 연결된 속성 시트 페이지를 검색합니다. |
| GetRegistryKey GetRegistryKey 메서드는 GPO의 지정된 섹션에 대한 레지스트리 키의 루트에 대한 핸들을 검색합니다. |
| GetRegistryKey GetRegistryKey 메서드는 지정된 GPO 섹션에 대한 레지스트리 키의 루트에 대한 핸들을 검색합니다. |
| GetType GetType 메서드는 편집 중인 GPO에 대한 형식 정보를 검색합니다. (IGPEInformation.GetType) |
| GetType GetType 메서드는 편집 중인 GPO에 대한 형식 정보를 검색합니다. (IGroupPolicyObject.GetType) |
| ImportRSoPData ImportRSoPData 함수는 RSoP 데이터가 포함된 데이터 파일을 WMI 네임스페이스로 가져옵니다. 파일은 ExportRSoPData 함수를 호출하여 생성해야 합니다. |
| InstallApplication InstallApplication 함수는 도메인에 속한 대상 사용자에게 배포된 애플리케이션을 설치할 수 있습니다. |
| LeaveCriticalPolicySection LeaveCriticalPolicySection 함수는 정책의 백그라운드 적용을 다시 시작합니다. 이 함수는 정책 섹션에 대한 핸들을 닫습니다. |
| 새로 만들기 New 메서드는 지정된 표시 이름을 사용하여 Active Directory에 새 GPO를 만듭니다. 메서드는 OpenDSGPO 메서드를 사용하여 GPO를 엽니다. |
| OpenDSGPO OpenDSGPO 메서드는 지정된 GPO를 열고 필요에 따라 레지스트리 정보를 로드합니다. |
| OpenLocalMachineGPO OpenLocalMachineGPO 메서드는 컴퓨터에 대한 기본 GPO를 열고 필요에 따라 레지스트리 정보를 로드합니다. |
| OpenRemoteMachineGPO OpenRemoteMachineGPO 메서드는 지정된 원격 컴퓨터에 대한 기본 GPO를 열고 필요에 따라 레지스트리 정보를 로드합니다. |
| PFNGENERATEGROUPPOLICY GenerateGroupPolicy 콜백 함수는 계획 모드에서 RSoP 데이터를 생성할 때 각 정책 확장이 내보내야 하는 애플리케이션 정의 콜백 함수입니다. |
| PFNPROCESSGROUPPOLICY ProcessGroupPolicy 함수는 정책을 적용할 때 사용되는 애플리케이션 정의 콜백 함수입니다. |
| PFNPROCESSGROUPPOLICYEX ProcessGroupPolicyEx 함수는 정책을 적용할 때 사용되는 애플리케이션 정의 콜백 함수입니다. |
| PFNSTATUSMESSAGECALLBACK StatusMessageCallback 함수는 정책을 적용할 때 상태 메시지를 표시하는 데 사용되는 애플리케이션 정의 콜백 함수입니다. |
| PolicyChanged PolicyChanged 메서드는 그룹 정책 개체 편집기에서 정책 설정이 변경되었다는 것을 알릴 수 있습니다. |
| ProcessGroupPolicyCompleted ProcessGroupPolicyCompleted 함수는 지정된 확장이 정책 적용을 완료했음을 시스템에 알릴 수 있습니다. |
| ProcessGroupPolicyCompletedEx ProcessGroupPolicyCompletedEx 함수는 지정된 정책 확장이 정책 적용을 완료했음을 시스템에 알릴 수 있습니다. 또한 함수는 RSoP(결과 정책 집합) 로깅의 상태 보고합니다. |
| RefreshPolicy RefreshPolicy 함수를 사용하면 정책이 클라이언트 컴퓨터에 즉시 적용됩니다. |
| RefreshPolicyEx RefreshPolicyEx 함수를 사용하면 정책이 컴퓨터에 즉시 적용됩니다. 확장 함수를 사용하면 적용할 정책 새로 고침 유형을 지정할 수 있습니다. |
| RegisterGPNotification RegisterGPNotification 함수를 사용하면 정책이 변경될 때 애플리케이션이 알림을 받을 수 있습니다. 정책 변경이 발생하면 지정된 이벤트 개체가 신호 상태로 설정됩니다. |
| RsopAccessCheckByType RSoPAccessCheckByType 함수는 보안 설명자가 RSOPTOKEN으로 식별된 클라이언트에 지정된 액세스 권한 집합을 부여하는지 여부를 결정합니다. |
| RsopFileAccessCheck RSoPFileAccessCheck 함수는 파일의 보안 설명자가 RSOPTOKEN으로 식별된 클라이언트에 지정된 파일 액세스 권한 집합을 부여하는지 여부를 결정합니다. |
| RsopResetPolicySettingStatus RSoPResetPolicySettingStatus 함수는 RSOP_PolicySetting instance RSOP_PolicySettingStatus instance 연결을 해제합니다. |
| RsopSetPolicySettingStatus RSoPSetPolicySettingStatus 함수는 RSOP_PolicySettingStatus instance RSOP_PolicySettingLink instance 만듭니다. 함수는 RSOP_PolicySetting instance RSOP_PolicySettingStatus 연결(연결)합니다. |
| 저장 Save 메서드는 지정된 레지스트리 정책 설정을 디스크에 저장하고 GPO의 수정 번호를 업데이트합니다. |
| SetDisplayName SetDisplayName 메서드는 GPO의 표시 이름을 설정합니다. |
| SetOptions SetOptions 메서드는 GPO에 대한 옵션을 설정합니다. |
| UninstallApplication UninstallApplication 함수는 Windows Installer .msi 파일을 사용하여 설치 및 설치를 처리하는 그룹 정책 애플리케이션을 제거합니다. |
| UnregisterGPNotification UnregisterGPNotification 함수는 정책 변경 알림 수신에서 지정된 정책 알림 핸들의 등록을 취소합니다. |
인터페이스
| IGPEInformation IGPEInformation 인터페이스는 MMC(Microsoft Management Console) 확장 스냅인이 그룹 정책 개체 편집기와 통신하는 메서드를 제공합니다. MMC에 대한 자세한 내용은 Microsoft 관리 콘솔을 참조하세요. |
| IGroupPolicyObject IGroupPolicyObject 인터페이스는 그룹 정책 개체 편집기를 사용하지 않고 GPO를 직접 만들고 수정하는 메서드를 제공합니다. |
| IRSOPInformation IRSOPInformation 인터페이스는 MMC(Microsoft Management Console) 확장 스냅인이 기본 RSoP(결과 정책 집합) 스냅인과 통신하는 메서드를 제공합니다. MMC에 대한 자세한 내용은 Microsoft 관리 콘솔을 참조하세요. |
구조체
| GPOBROWSEINFO GPOBROWSEINFO 구조체에는 BrowseForGPO 함수가 GPO 브라우저 대화 상자를 초기화하는 데 사용하는 정보가 포함되어 있습니다. 사용자가 대화 상자를 닫은 후 시스템은 이 구조에서 사용자의 작업에 대한 정보를 반환합니다. |
| GROUP_POLICY_OBJECTA GROUP_POLICY_OBJECT 구조체는 GPO 목록의 GPO에 대한 정보를 제공합니다. (ANSI) |
| GROUP_POLICY_OBJECTW GROUP_POLICY_OBJECT 구조체는 GPO 목록의 GPO에 대한 정보를 제공합니다. (유니코드) |
| INSTALLDATA INSTALLDATA 구조는 InstallApplication에서 설치할 그룹 정책 애플리케이션을 지정합니다. |
| INSTALLSPEC INSTALLSPEC 구조는 사용자에게 친숙한 이름 및 그룹 정책 GUID 또는 파일 이름 확장명을 사용하여 그룹 정책 애플리케이션을 지정합니다. INSTALLDATA 구조체의 Spec 멤버는 이 정보를 InstallApplication 함수에 제공합니다. |
| LOCALMANAGEDAPPLICATION LOCALMANAGEDAPPLICATION 구조는 사용자 또는 컴퓨터에 대해 설치된 관리되는 애플리케이션을 설명합니다. GetLocalManagedApplications 함수에서 반환됩니다. |
| MANAGEDAPPLICATION MANAGEDAPPLICATION 구조에는 애플리케이션에 대한 정보가 포함됩니다. GetManagedApplications 함수는 MANAGEDAPPLICATION 구조체의 배열을 반환합니다. |
| POLICYSETTINGSTATUSINFO POLICYSETTINGSTATUSINFO 구조는 정책 설정 이벤트에 대한 정보를 제공합니다. |
| RSOP_TARGET RSOP_TARGET 구조에는 GenerateGroupPolicy 함수에 필요한 컴퓨터 및 사용자 정보가 포함됩니다. |